Skip to content

Latest commit

 

History

History
68 lines (55 loc) · 2.38 KB

copy.md

File metadata and controls

68 lines (55 loc) · 2.38 KB

copy(src, dest[, options][, callback])

Copy a file or directory. The directory can have contents.

  • src <String> Note that if src is a directory it will copy everything inside of this directory, not the entire directory itself (see issue #537).
  • dest <String> Note that if src is a file, dest cannot be a directory (see issue #323).
  • options <Object>
    • overwrite <boolean>: overwrite existing file or directory, default is true. Note that the copy operation will silently fail if you set this to false and the destination exists. Use the errorOnExist option to change this behavior.
    • errorOnExist <boolean>: when overwrite is false and the destination exists, throw an error. Default is false.
    • dereference <boolean>: dereference symlinks, default is false.
    • preserveTimestamps <boolean>: When true, will set last modification and access times to the ones of the original source files. When false, timestamp behavior is OS-dependent. Default is false.
    • filter <Function>: Function to filter copied files/directories. Return true to copy the item, false to ignore it. Can also return a Promise that resolves to true or false (or pass in an async function).
  • callback <Function>
    • err <Error>

Example:

const fs = require('fs-extra')

// With a callback:
fs.copy('/tmp/myfile', '/tmp/mynewfile', err => {
  if (err) return console.error(err)
  console.log('success!')
}) // copies file

fs.copy('/tmp/mydir', '/tmp/mynewdir', err => {
  if (err) return console.error(err)
  console.log('success!')
}) // copies directory, even if it has subdirectories or files

// With Promises:
fs.copy('/tmp/myfile', '/tmp/mynewfile')
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example () {
  try {
    await fs.copy('/tmp/myfile', '/tmp/mynewfile')
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example()

Using filter function

const fs = require('fs-extra')

const filterFunc = (src, dest) => {
  // your logic here
  // it will be copied if return true
}

fs.copy('/tmp/mydir', '/tmp/mynewdir', { filter: filterFunc }, err => {
  if (err) return console.error(err)
  console.log('success!')
})