diff options
author | dustinnewman98 <dustinnewman98@gmail.com> | 2018-02-18 03:09:05 +0300 |
---|---|---|
committer | Myles Borins <mylesborins@google.com> | 2018-08-16 08:59:12 +0300 |
commit | a1902caf09ea974110f485d0111581e56ab30f81 (patch) | |
tree | 029bc345acdbd8a5392610f7129d4fada8cda56e /doc | |
parent | 8c5ad68add37d1b51ffe3a30f4381a91ea5dc99f (diff) |
doc: improved documentation for fs.unlink()
Refs: https://github.com/nodejs/node/issues/11135
PR-URL: https://github.com/nodejs/node/pull/18843
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Matheus Marchini <matheus@sthima.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/api/fs.md | 18 |
1 files changed, 16 insertions, 2 deletions
diff --git a/doc/api/fs.md b/doc/api/fs.md index 510a44b9f2d..3fbdfc34726 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -2444,8 +2444,21 @@ changes: * `callback` {Function} * `err` {Error} -Asynchronous unlink(2). No arguments other than a possible exception are given -to the completion callback. +Asynchronously removes a file or symbolic link. No arguments other than a +possible exception are given to the completion callback. + +```js +// Assuming that 'path/file.txt' is a regular file. +fs.unlink('path/file.txt', (err) => { + if (err) throw err; + console.log('path/file.txt was deleted'); +}); +``` + +`fs.unlink()` will not work on a directory, empty or otherwise. To remove a +directory, use [`fs.rmdir()`][]. + +See also: unlink(2) ## fs.unlinkSync(path) <!-- YAML @@ -3173,6 +3186,7 @@ The following constants are meant for use with the [`fs.Stats`][] object's [`fs.read()`]: #fs_fs_read_fd_buffer_offset_length_position_callback [`fs.readFile()`]: #fs_fs_readfile_path_options_callback [`fs.readFileSync()`]: #fs_fs_readfilesync_path_options +[`fs.rmdir()`]: #fs_fs_rmdir_path_callback [`fs.stat()`]: #fs_fs_stat_path_callback [`fs.utimes()`]: #fs_fs_utimes_path_atime_mtime_callback [`fs.watch()`]: #fs_fs_watch_filename_options_listener |