Skip to content
Related Articles

Related Articles

Node.js fs.promises.link() Method
  • Last Updated : 23 Jul, 2020

The fs.promises.link() method is an inbuilt application programming interface of the fs.promises class which is used to make a new name for a file.

Syntax:

fs.promises.link(existing_path, new_path);

Parameters: This method accept two parameters as mentioned above and described below:

  • existing_path: It is a required parameter specifies a string/URL/Buffer which denotes the existing path of the file.
  • new_path: It is a required parameter specifies a string/URL/Buffer which denotes the new path for the file.

Return Value: It returns a promise. If the linking is successful the promise is resolved with no value, otherwise rejected with an error object.

Below examples illustrate the use of fs.promises.link() method in Node.js:



Example 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!'));

Output:

(node:5052) ExperimentalWarning: The fs.promises API is experimental
linked successfully

Example 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!'));

Output:

(node:11936) ExperimentalWarning: The fs.promises API is experimental
failed to link!

Note: The above program will compile and run by using the node filename.js command and use the file_path correctly.

Reference: https://nodejs.org/api/fs.html#fs_fspromises_link_existingpath_newpath

Attention reader! Don’t stop learning now. Get hold of all the important DSA concepts with the DSA Self Paced Course at a student-friendly price and become industry ready.

My Personal Notes arrow_drop_up
Recommended Articles
Page :