Node.js fs.promises.link() Method

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::

Output:

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

Example 2:

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