Método Node.js fs.readlink()

El método fs.readlink() es una interfaz de programación de aplicaciones incorporada del módulo fs que se utiliza para devolver de forma asíncrona el valor de un enlace simbólico, es decir, la ruta a la que está vinculado. El argumento opcional se puede utilizar para especificar la codificación de caracteres de la ruta del enlace.

Sintaxis:

fs.readlink( path[, options], callback )

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

• ruta: Es una string, Buffer o URL que representa la ruta del enlace simbólico.
• opciones: es un objeto o string que se puede usar para especificar parámetros opcionales que afectarán la salida. Tiene un parámetro opcional:
  • codificación: Es un valor de string que especifica la codificación de caracteres en la que se devuelve la ruta del enlace. El valor predeterminado es ‘utf8’.
• 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 falla.
  • linkString: Es la string u objeto Buffer que contiene el valor de la string del enlace simbólico.

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

Ejemplo 1: este ejemplo lee el valor del enlace simbólico de un archivo y también cambia la codificación del valor.

// Node.js program to demonstrate the
// fs.readlink() method
  
// Import the filesystem module
const fs = require('fs');
  
// Create a symbolic link
fs.symlinkSync(__dirname + "\\example_file.txt", 
                       "symlinkToFile", 'file');
  
console.log("\nSymlink created\n");
  
// Using the default utf-8 encoding for the link value
fs.readlink("symlinkToFile", (err, linkString) => {
  if (err)
    console.log(err);
  else
    console.log("Path of the symlink:", linkString);
});
  
  
// Using the base64 encoding for the link value
fs.readlink("symlinkToFile", 
  
  // Specify the options object
  {encoding: "base64"},
  (err, linkString) => {
    if (err)
      console.log(err);
    else
      console.log("Path in base64:", linkString);
});

Producción:

Enlace simbólico creado

Ruta del enlace simbólico: G:\tutorials\nodejs-fs-readlink\example_file.txt
Ruta en base64: RzpcdHV0b3JpYWxzXG5vZGVqcy1mcy1yZWFkbGlua1xleGFtcGxlX2ZpbGUudHh0

Ejemplo 2: este ejemplo lee el valor de un enlace simbólico para un directorio.

// Node.js program to demonstrate the
// fs.readlink() method
  
// Import the filesystem module
const fs = require('fs');
  
// Create a symbolic link
fs.symlinkSync(__dirname + "\\example_directory", 
            "symlinkToDir", 'dir');
  
console.log("\nSymlink created\n");
  
fs.readlink("symlinkToDir", (err, linkString) => {
  if (err)
    console.log(err);
  else
    console.log("Path of the symlink:", linkString);
});

Producción:

Enlace simbólico creado

Ruta del enlace simbólico: G:\tutorials\nodejs-fs-readlink\example_directory

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