Node.js fs.copyFileSync(src, dest[, mode])用法及代碼示例

fs.copyFileSync(src, dest[, mode])

參數

• src <string> | <Buffer> | <URL> 要複製的源文件名
• dest <string> | <Buffer> | <URL> 複製操作的目標文件名
• mode <integer> 用於複製操作的修飾符。 默認： 0 。

將 src 同步複製到 dest 。默認情況下，如果 dest 已經存在，它會被覆蓋。返回 undefined 。 Node.js 不保證複製操作的原子性。如果在打開目標文件進行寫入後發生錯誤，Node.js 將嘗試刪除目標。

mode 是一個可選整數，用於指定複製操作的行為。可以創建由兩個或多個值的按位或組成的掩碼(例如 fs.constants.COPYFILE_EXCL | fs.constants.COPYFILE_FICLONE )。

• fs.constants.COPYFILE_EXCL ：如果 dest 已存在，則複製操作將失敗。
• fs.constants.COPYFILE_FICLONE ：複製操作將嘗試創建 copy-on-write reflink。如果平台不支持copy-on-write，則使用回退複製機製。
• fs.constants.COPYFILE_FICLONE_FORCE ：複製操作將嘗試創建 copy-on-write reflink。如果平台不支持copy-on-write，則操作將失敗。

import { copyFileSync, constants } from 'node:fs';

// destination.txt will be created or overwritten by default.
copyFileSync('source.txt', 'destination.txt');
console.log('source.txt was copied to destination.txt');

// By using COPYFILE_EXCL, the operation will fail if destination.txt exists.
copyFileSync('source.txt', 'destination.txt', constants.COPYFILE_EXCL);