Node.js fs.copyFile實例講解

fs.copyFile()方法用于將文件從源路徑異步復制到目標路徑。默認情況下,Node.js將覆蓋文件(如果文件已存在于給定的目的地)?？蛇x的mode參數可用于修改復制操作的行為。

用法:

fs.copyFile( src, dest, mode, callback )

參數:該方法接受上述和以下描述的三個參數:

• src:它是一個字符串,緩沖區或URL,表示要復制的源文件名。
• dest:它是一個字符串,緩沖區或URL,表示復制操作將創建的目標文件名。
• mode:它是一個整數,指定復制操作的行為?？梢詾檫@些值提供預定義的常量,這些常量具有各自的行為:
  • fs.constants.COPYFILE_EXCL:該常數指定如果目標文件名已經存在,則復制操作將失敗。
  • fs.constants.COPYFILE_FICLONE:該常數指定復制操作將嘗試創建copy-on-write reflink。如果平臺不支持copy-on-write,則使用回退機制。
  • fs.constants.COPYFILE_FICLONE_FORCE:該常數指定復制操作將嘗試創建copy-on-write reflink。如果平臺不支持copy-on-write,則失敗將失敗,與之前的平臺不同。

  這些常量也可以與按位或組合以創建多個值的掩碼。它是一個可選參數。該參數的默認值為0。

• callback:該方法執行時將調用該函數。
  • err:如果方法失敗,將引發錯誤。

以下示例說明了Node.js中的fs.copyFile()方法:

范例1:本示例顯示了“example_file.txt”文件到“copied_file.txt”文件的復制操作。

// Node.js program to demonstrate the // fs.copyFile() method ??// Import the filesystem module const fs = require('fs'); ??// Get the current filenames // before the function getCurrentFilenames(); console.log("\nFile Contents of example_file:", ??fs.readFileSync("example_file.txt", "utf8")); ??// Copying the file to a the same name fs.copyFile("example_file.txt", "copied_file.txt", (err) => { ??if (err) { ????console.log("Error Found:", err); ??} ??else { ??????// Get the current filenames ????// after the function ????getCurrentFilenames(); ????console.log("\nFile Contents of copied_file:", ??????fs.readFileSync("copied_file.txt", "utf8")); ??} }); ??// Function to get current filenames // in directory function getCurrentFilenames() { ??console.log("\nCurrent filenames:"); ??fs.readdirSync(__dirname).forEach(file => { ????console.log(file); ??}); }

輸出:

Current filenames:example_file.txtindex.jsFile Contents of example_file:This is a test file.Current filenames:copied_file.txtexample_file.txtindex.jsFile Contents of copied_file:This is a test file.

范例2:本示例說明了目標已存在時復制操作失敗。

// Node.js program to demonstrate the // fs.copyFile() method ??// Import the filesystem module const fs = require('fs'); ??// Get the current filenames // before the function getCurrentFilenames(); console.log("\nFile Contents of example_file:",? ??????fs.readFileSync("example_file.txt", "utf8")); ??// Copying the file to a the same name fs.copyFile("example_file.txt", "copied_file.txt",? ??????fs.constants.COPYFILE_EXCL, (err) => { ??if (err) { ????console.log("Error Found:", err); ??} ??else { ??????// Get the current filenames ????// after the function ????getCurrentFilenames(); ????console.log("\nFile Contents of copied_file:", ??????fs.readFileSync("copied_file.txt", "utf8")); ??} }); ??// Function to get current filenames // in directory function getCurrentFilenames() { ??console.log("\nCurrent filenames:"); ??fs.readdirSync(__dirname).forEach(file => { ????console.log(file); ??}); }

輸出:

Current filenames:copied_file.txtexample_file.txtindex.jsFile Contents of example_file:This is a test file.Error:[Error:EEXIST:file already exists, copyfile   'G:\tutorials\nodejs-fs-copyFile\example_file.txt' ->   'G:\tutorials\nodejs-fs-copyFile\copied_file.txt'] {  errno:-4075,  code:'EEXIST',  syscall:'copyfile',  path:'G:\\tutorials\\nodejs-fs-copyFile\\example_file.txt',  dest:'G:\\tutorials\\nodejs-fs-copyFile\\copied_file.txt'}

參考: https://nodejs.org/api/fs.html#fs_fs_copyfile_src_dest_mode_callback