Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@npmcli/move-file

npm50.9mMITdeprecated3.0.0

This functionality has been moved to @npmcli/fs

move a file (fork of move-file)

readme

@npmcli/move-file

A fork of move-file with compatibility with all node 10.x versions.

Move a file (or directory)

The built-in fs.rename() is just a JavaScript wrapper for the C rename(2) function, which doesn't support moving files across partitions or devices. This module is what you would have expected fs.rename() to be.

Highlights

  • Promise API.
  • Supports moving a file across partitions and devices.
  • Optionally prevent overwriting an existing file.
  • Creates non-existent destination directories for you.
  • Support for Node versions that lack built-in recursive fs.mkdir()
  • Automatically recurses when source is a directory.

Install

$ npm install @npmcli/move-file

Usage

const moveFile = require('@npmcli/move-file');

(async () => {
    await moveFile('source/unicorn.png', 'destination/unicorn.png');
    console.log('The file has been moved');
})();

API

moveFile(source, destination, options?)

Returns a Promise that resolves when the file has been moved.

moveFile.sync(source, destination, options?)

source

Type: string

File, or directory, you want to move.

destination

Type: string

Where you want the file or directory moved.

options

Type: object

overwrite

Type: boolean\ Default: true

Overwrite existing destination file(s).

changelog

Changelog

3.0.0 (2022-10-10)

⚠️ BREAKING CHANGES

  • @npmcli/move-file is now compatible with the following semver range for node: ^14.17.0 || ^16.13.0 || >=18.0.0

Features

  • 401b148 #29 postinstall for dependabot template-oss PR (@lukekarrys)

2.0.1 (2022-08-15)

Bug Fixes

2.0.0 (2022-04-05)

⚠ BREAKING CHANGES

  • this drops support for node 10 and non-LTS versions of node 12 and node 14

Dependencies