Método Node.js fs.fstatSync()

El método fs.fstatSync() se utiliza para devolver información de forma síncrona sobre el descriptor de archivo dado. El objeto fs.Stat devuelve varios campos y métodos para obtener más detalles sobre el archivo.

Sintaxis:

fstatSync( fd, options )

Parámetros: Este método acepta dos parámetros como se mencionó anteriormente y se describe a continuación:

• fd: Es un valor entero que representa el descriptor de archivo utilizado por el método.
• opciones: es un objeto que se puede usar para especificar parámetros opcionales que afectarán la salida. Tiene un parámetro opcional:
  • bigint: Es un valor booleano que especifica si los valores numéricos devueltos en el objeto fs.Stats son bigint. El valor predeterminado es falso.

Los siguientes ejemplos ilustran el método fs.fstatSync() en Node.js:

Ejemplo 1: este ejemplo utiliza el método fs.fstatSync() para obtener los detalles de un archivo y un directorio.

// Node.js program to demonstrate the
// fs.fstatSync() method
  
// Import the filesystem module
const fs = require('fs');
  
const file_fd = fs.openSync('example_file.txt', 'r');
  
// Getting information for a file
let fileStat = fs.fstatSync(file_fd);
  
console.log("Stats object for: example_file.txt");
console.log(fileStat);
  
// Using methods of the Stats object
console.log("Path is file:", fileStat.isFile());
console.log("Path is directory:", fileStat.isDirectory());
  
const dir_fd = fs.openSync('example_directory', 'r');
  
// Getting information for a directory
let dirStat = fs.fstatSync(dir_fd);
  
console.log("Stats object for: example_directory");
console.log(dirStat);
  
// Using methods of the Stats object
console.log("Path is file:", dirStat.isFile());
console.log("Path is directory:", dirStat.isDirectory());

Producción:

Stats object for: example_file.txt
Stats {
  dev: 3229478529,
  mode: 33206,
  nlink: 1,
  uid: 0,
  gid: 0,
  rdev: 0,
  blksize: 4096,
  ino: 281474976780786,
  size: 0,
  blocks: 0,
  atimeMs: 1584961030299.117,
  mtimeMs: 1582209885466.6848,
  ctimeMs: 1582209885466.6848,
  birthtimeMs: 1584961030299.117,
  atime: 2020-03-23T10:57:10.299Z,
  mtime: 2020-02-20T14:44:45.467Z,
  ctime: 2020-02-20T14:44:45.467Z,
  birthtime: 2020-03-23T10:57:10.299Z
}
Path is file: true
Path is directory: false
Stats object for: example_directory
Stats {
  dev: 3229478529,
  mode: 16822,
  nlink: 1,
  uid: 0,
  gid: 0,
  rdev: 0,
  blksize: 4096,
  ino: 281474976780789,
  size: 0,
  blocks: 0,
  atimeMs: 1584961090214.9436,
  mtimeMs: 1581074249467.7114,
  ctimeMs: 1584961030324.12,
  birthtimeMs: 1584961030324.12,
  atime: 2020-03-23T10:58:10.215Z,
  mtime: 2020-02-07T11:17:29.468Z,
  ctime: 2020-03-23T10:57:10.324Z,
  birthtime: 2020-03-23T10:57:10.324Z
}
Path is file: false
Path is directory: true

Ejemplo 2: este ejemplo utiliza el método fs.fstatSync() para obtener los detalles de un archivo con y sin la opción bigint.

// Node.js program to demonstrate the
// fs.fstatSync() method
  
// Import the filesystem module
const fs = require('fs');
  
const file_fd = fs.openSync('example_file.txt', 'r');
  
let fileStat = fs.fstatSync(file_fd);
console.log(fileStat);
  
// Using the bigint option to return
// the values in big integer format
let fileBigIntStat = fs.fstatSync(file_fd, { bigint: true });
console.log(fileBigIntStat);

Producción:

Stats {
  dev: 3229478529,
  mode: 33206,
  nlink: 1,
  uid: 0,
  gid: 0,
  rdev: 0,
  blksize: 4096,
  ino: 281474976780786,
  size: 0,
  blocks: 0,
  atimeMs: 1584961030299.117,
  mtimeMs: 1582209885466.6848,
  ctimeMs: 1582209885466.6848,
  birthtimeMs: 1584961030299.117,
  atime: 2020-03-23T10:57:10.299Z,
  mtime: 2020-02-20T14:44:45.467Z,
  ctime: 2020-02-20T14:44:45.467Z,
  birthtime: 2020-03-23T10:57:10.299Z
}
BigIntStats {
  dev: 3229478529n,
  mode: 33206n,
  nlink: 1n,
  uid: 0n,
  gid: 0n,
  rdev: 0n,
  blksize: 4096n,
  ino: 281474976780786n,
  size: 0n,
  blocks: 0n,
  atimeMs: 1584961030299n,
  mtimeMs: 1582209885466n,
  ctimeMs: 1582209885466n,
  birthtimeMs: 1584961030299n,
  atimeNs: 1584961030299117000n,
  mtimeNs: 1582209885466684900n,
  ctimeNs: 1582209885466684900n,
  birthtimeNs: 1584961030299117000n,
  atime: 2020-03-23T10:57:10.299Z,
  mtime: 2020-02-20T14:44:45.466Z,
  ctime: 2020-02-20T14:44:45.466Z,
  birthtime: 2020-03-23T10:57:10.299Z
}

Referencia: https://nodejs.org/api/fs.html#fs_fs_fstatsync_fd_options