fsPromises.rmdir(path[, options])

版本历史

版本	变更
v16.0.0	Using `fsPromises.rmdir(path, { recursive: true })` on a `path` that is a file is no longer permitted and results in an `ENOENT` error on Windows and an `ENOTDIR` error on POSIX.
v16.0.0	Using `fsPromises.rmdir(path, { recursive: true })` on a `path` that does not exist is no longer permitted and results in a `ENOENT` error.
v16.0.0	The `recursive` option is deprecated, using it triggers a deprecation warning.
v14.14.0	The `recursive` option is deprecated, use `fsPromises.rm` instead.
v13.3.0, v12.16.0	The `maxBusyTries` option is renamed to `maxRetries`, and its default is 0. The `emfileWait` option has been removed, and `EMFILE` errors use the same retry logic as other errors. The `retryDelay` option is now supported. `ENFILE` errors are now retried.
v12.10.0	The `recursive`, `maxBusyTries`, and `emfileWait` options are now supported.
v10.0.0	新增于: v10.0.0

path <string> | <Buffer> | <URL>
options <Object>
- maxRetries <integer> 如果遇到 EBUSY、EMFILE、ENFILE、ENOTEMPTY 或 EPERM 错误，Node.js 会以线性回退的方式重试操作，每次重试等待时间比上次增加 retryDelay 毫秒。此选项表示重试次数。如果 recursive 选项不是 true，此选项将被忽略。默认值： 0。
- recursive <boolean> 如果为 true，则执行递归目录删除。在递归模式下，操作在失败时会重试。默认值： false。 已弃用。
- retryDelay <integer> 重试之间等待的时间，以毫秒为单位。如果 recursive 选项不为 true，则此选项将被忽略。默认值: 100。
返回：<Promise> 成功时返回 undefined。

删除由 path 指定的目录。

【Removes the directory identified by path.】

在文件（而不是目录）上使用 fsPromises.rmdir() 会导致在 Windows 上 Promise 被拒绝并返回 ENOENT 错误，而在 POSIX 上返回 ENOTDIR 错误。

【Using fsPromises.rmdir() on a file (not a directory) results in the promise being rejected with an ENOENT error on Windows and an ENOTDIR error on POSIX.】

要获得类似于 rm -rf Unix 命令的行为，请使用 fsPromises.rm()，并设置选项 { recursive: true, force: true }。

【To get a behavior similar to the rm -rf Unix command, use fsPromises.rm() with options { recursive: true, force: true }.】