Node.js fs.lstat()用法及代碼示例

fs.lstat()方法與fs.stat()方法類似，不同之處在於它用於返回有關用於引用文件或目錄的符號鏈接的信息。返回的fs.Stat對象具有多個字段和方法，以獲取有關文件的更多詳細信息。

用法:

fs.lstat( path, options, callback )

參數：此方法接受上述和以下所述的三個參數：

• path:它是一個字符串，緩衝區或URL，其中包含符號鏈接的路徑。
• options:該對象可用於指定將影響輸出的可選參數。它具有一個可選參數：
  • bigint:它是一個布爾值，它指定fs.Stats對象中返回的數值是否為bigint。默認值為false。
• callback:執行該方法時將調用該函數。
  • err:如果使用該方法，則會引發錯誤。
  • Stats:Stats對象包含文件路徑的詳細信息。

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

範例1：本示例使用fs.lstat()方法獲取文件符號鏈接的詳細信息。

// Node.js program to demonstrate the 
// fs.lstat() method 
  
// Import the filesystem module 
const fs = require('fs'); 
  
fs.symlinkSync(__dirname + "\\example_file.txt", 
                        "symlinkToFile", 'file'); 
console.log("Symlink to file created") 
  
fs.lstat("symlinkToFile", (err, stats) => { 
  if (err) 
    console.log(err); 
  else { 
    console.log("Stat of symlinkToFile") 
    console.log(stats); 
  } 
});

輸出：

Symlink to file created
Stat of symlinkToFile
Stats {
  dev:3229478529,
  mode:41398,
  nlink:1,
  uid:0,
  gid:0,
  rdev:0,
  blksize:4096,
  ino:281474976780939,
  size:45,
  blocks:0,
  atimeMs:1585207132017.4473,
  mtimeMs:1585207132017.4473,
  ctimeMs:1585207132017.4473,
  birthtimeMs:1585207132017.4473,
  atime:2020-03-26T07:18:52.017Z,
  mtime:2020-03-26T07:18:52.017Z,
  ctime:2020-03-26T07:18:52.017Z,
  birthtime:2020-03-26T07:18:52.017Z
}

範例2：本示例使用fs.lstat()方法獲取指向文件夾的符號鏈接的詳細信息。

// Node.js program to demonstrate the 
// fs.lstat() method 
  
// Import the filesystem module 
const fs = require('fs'); 
  
fs.symlinkSync(__dirname + "\\example_directory", 
                          "symlinkToDir", 'dir'); 
  
console.log("Symlink to directory created") 
  
fs.lstat("symlinkToDir", (err, stats) => { 
  if (err) 
    console.log(err); 
  else { 
    console.log("Stat of symlinkToDir") 
    console.log(stats); 
  } 
});

輸出：

Symlink to directory created
Stat of symlinkToDir
Stats {
  dev:3229478529,
  mode:41398,
  nlink:1,
  uid:0,
  gid:0,
  rdev:0,
  blksize:4096,
  ino:281474976780940,
  size:46,
  blocks:0,
  atimeMs:1585207184224.7136,
  mtimeMs:1585207184224.7136,
  ctimeMs:1585207184224.7136,
  birthtimeMs:1585207184224.7136,
  atime:2020-03-26T07:19:44.225Z,
  mtime:2020-03-26T07:19:44.225Z,
  ctime:2020-03-26T07:19:44.225Z,
  birthtime:2020-03-26T07:19:44.225Z
}

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