Repository files navigation

Move a file

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

• Promise API.
• Supports moving a file across partitions and devices.
• Optionally prevent overwriting an existing file.
• Creates non-existent destination directories for you.

npm install move-file

import{moveFile}from'move-file';awaitmoveFile('source/unicorn.png','destination/unicorn.png');console.log('The file has been moved');

Returns aPromise that resolves when the file has been moved.

Type:string

The file you want to move.

Type:string

Where you want the file moved.

Type:object

SeeOptions.

Returns aPromise that resolves when the file has been renamed.source anddestination must be in the same directory.

Type:string

The file you want to rename.

Type:string

What you want to rename the file to.

Type:object

SeeOptions.

Type:boolean
Default:true

Overwrite existing destination file.

Type:string
Default:process.cwd()

The working directory to find source files.

The source and destination path are relative to this.

Type:number
Default:0o777

Permissions for created directories.

It has no effect on Windows.

• move-file-cli - CLI for this module
• copy-file - Copy a file
• cpy - Copy files
• make-dir - Make a directory and its parents if needed