El método fs.promises.link() es una interfaz de programación de aplicaciones incorporada de la clase fs.promises que se utiliza para crear un nuevo nombre para un archivo.
Sintaxis:
fs.promises.link(existing_path, new_path);
Parámetros: Este método acepta dos parámetros como se mencionó anteriormente y se describe a continuación:
- ruta_existente: es un parámetro obligatorio que especifica una string/URL/búfer que denota la ruta existente del archivo.
- new_path: es un parámetro requerido que especifica una string/URL/búfer que denota la nueva ruta para el archivo.
Valor devuelto: Devuelve una promesa. Si la vinculación es exitosa, la promesa se resuelve sin valor; de lo contrario, se rechaza con un objeto de error.
Los siguientes ejemplos ilustran el uso del método fs.promises.link() en Node.js:
Ejemplo 1: :
Javascript
// Accessing fs module
const fs = require('fs');
const fsPromises = fs.promises;
// fs.promises link
fsPromises.link('./filename.txt','../filename.txt')
.then(() => console.log('linked successfully'))
.catch(() => console.error('failed to link!'));
Salida :
(node:5052) ExperimentalWarning: The fs.promises API is experimental linked successfully
Ejemplo 2 :
Javascript
// Accessing fs module
const {
promises: fsPromises
} = require('fs');
// Not work for directory
// fs.promises link
fsPromises.link('../dir_name','./dir_name')
.then(() => console.log('linked successfully'))
.catch(() => console.error('failed to link!'));
Salida :
(node:11936) ExperimentalWarning: The fs.promises API is experimental failed to link!
Nota : El programa anterior se compilará y ejecutará usando el node filename.jscomando y usará file_path correctamente.
Referencia: https://nodejs.org/api/fs.html#fs_fspromises_link_existingpath_newpath