Node.js中的fs.fstatSync方法使用说明

一、方法介绍

fs.fstatSync(fd[, options]) 方法返回传入文件描述符的文件信息。该方法是同步（阻塞）的。

参数说明

• fd：文件描述符，类型为整数。
• options：可选参数，类型为对象，包含以下属性。
• bigint：默认值为 false，表示返回的 stats 对象中的数值类型为 Number；如果设置为 true，则数值类型为 BigInt。

返回值说明

返回值为一个 fs.Stats 对象，其中包含了文件的详细信息。

二、示例

示例1：获取文件的详细信息

下面的示例使用 fs.fstatSync() 方法获取文件的详细信息：

const fs = require('fs');

const fd = fs.openSync('file.txt', 'r');

const stats = fs.fstatSync(fd);

console.log(stats);

输出结果为：

Stats {
  dev: 16777220,
  mode: 33188,
  nlink: 1,
  uid: 501,
  gid: 20,
  rdev: 0,
  blksize: 4096,
  ino: 85493598,
  size: 17,
  blocks: 8,
  atimeMs: 1635422144499.875,
  mtimeMs: 1635422144499.875,
  ctimeMs: 1635422144499.875,
  birthtimeMs: 1635422144173.3972,
  atime: 2021-10-28T06:09:04.500Z,
  mtime: 2021-10-28T06:09:04.500Z,
  ctime: 2021-10-28T06:09:04.500Z,
  birthtime: 2021-10-28T06:09:04.173Z
}

示例2：获取文件的大小

下面的示例使用 fs.fstatSync() 方法获取文件大小：

const fs = require('fs');

const fd = fs.openSync('file.txt', 'r');

const stats = fs.fstatSync(fd);

console.log(stats.size);

输出结果为：

17

三、注意事项

• fd 参数需要使用 fs.openSync() 方法获取。
• 该方法是同步（阻塞）的，会阻塞进程直到返回文件信息后才能继续执行下去。如果需要异步获取文件信息，可以使用 fs.fstat() 方法。