fs.cp(src, dest[, options], callback)

版本历史
版本变更
v18.0.0

将无效回调传给 callback 参数现在会抛出 ERR_INVALID_ARG_TYPE 而不是 ERR_INVALID_CALLBACK。

v17.6.0

接受额外的 verbatimSymlinks 选项来指定是否为符号链接执行路径解析。

v16.7.0

新增于: v16.7.0

    将整个目录结构从 src 异步地复制到 dest，包括子目录和文件。

    History
    VersionChanges
    v18.0.0

    Passing an invalid callback to the callback argument now throws ERR_INVALID_ARG_TYPE instead of ERR_INVALID_CALLBACK.

    v17.6.0

    Accepts an additional verbatimSymlinks option to specify whether to perform path resolution for symlinks.

    v16.7.0

    Added in: v16.7.0

    Stability: 1 - Experimental

    • src <string> | <URL> source path to copy.
    • dest <string> | <URL> destination path to copy to.
    • options <Object>
      • dereference <boolean> dereference symlinks. Default: false.
      • errorOnExist <boolean> when force is false, and the destination exists, throw an error. Default: 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 Default: undefined.
      • force <boolean> overwrite existing file or directory. The copy operation will ignore errors if you set this to false and the destination exists. Use the errorOnExist option to change this behavior. Default: true.
      • preserveTimestamps <boolean> When true timestamps from src will be preserved. Default: false.
      • recursive <boolean> copy directories recursively Default: false
      • verbatimSymlinks <boolean> When true, path resolution for symlinks will be skipped. Default: false
    • callback <Function>

    Asynchronously copies the entire directory structure from src to dest, including subdirectories and files.

    When copying a directory to another directory, globs are not supported and behavior is similar to cp dir1/ dir2/.