Método Node.js fs.lstat()

El método fs.lstat() es similar al método fs.stat() excepto que se usa para devolver información sobre el enlace simbólico que se usa para hacer referencia a un archivo o directorio. El objeto fs.Stat devuelto tiene varios campos y métodos para obtener más detalles sobre el archivo.

Sintaxis:

fs.lstat( path, options, callback )

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

• ruta: Es un String, Buffer o URL que contiene la ruta del enlace simbólico.
• 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.
• callback: Es la función que sería llamada cuando se ejecuta el método.
  • err: Es un error que se lanzaría si el método.
  • Stats: Es el objeto Stats que contiene los detalles de la ruta del archivo.

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

Ejemplo 1: este ejemplo utiliza el método fs.lstat() para obtener los detalles de un enlace simbólico a un archivo.

// 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);
  }
});

Producción:

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
}

Ejemplo 2: este ejemplo utiliza el método fs.lstat() para obtener los detalles de un enlace simbólico a una carpeta.

// 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);
  }
});

Producción:

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
}

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