Package Exports
- @npmcli/move-file
- @npmcli/move-file/lib/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@npmcli/move-file) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
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-fileUsage
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).