fsPromises.rmdir(path[, options])

版本历史

版本	变更
v25.0.0	删除 `recursive` 选项。
v16.0.0	不再允许在作为文件的 `path` 上使用 `fsPromises.rmdir(path, { recursive: true })`，这会在 Windows 上导致 `ENOENT` 错误，在 POSIX 上导致 `ENOTDIR` 错误。
v16.0.0	不再允许在不存在的 `path` 上使用 `fsPromises.rmdir(path, { recursive: true })`，这会导致 `ENOENT` 错误。
v16.0.0	选项 `recursive` 已弃用，使用它会触发弃用警告。
v14.14.0	不推荐使用 `recursive` 选项，请改用 `fsPromises.rm`。
v13.3.0, v12.16.0	选项 `maxBusyTries` 重命名为 `maxRetries`，默认值为 0。选项 `emfileWait` 已删除，并且 `EMFILE` 错误使用与其他错误相同的重试逻辑。现在支持 `retryDelay` 选项。现在重试 `ENFILE` 错误。
v12.10.0	现在支持 `recursive`、`maxBusyTries` 和 `emfileWait` 选项。
v10.0.0	新增于: v10.0.0

path <string> | <Buffer> | <URL>
options <Object> 目前没有公开任何选项。recursive、maxBusyTries 和 emfileWait 过去曾有选项，但它们已被弃用并移除。为了向后兼容，options 参数仍然被接受，但已不再使用。

¥options <Object> There are currently no options exposed. There used to be options for recursive, maxBusyTries, and emfileWait but they were deprecated and removed. The options argument is still accepted for backwards compatibility but it is not used.
返回：<Promise> 成功时将使用 undefined 履行。

¥Returns: <Promise> Fulfills with undefined upon success.

删除由 path 标识的目录。

¥Removes the directory identified by path.

在文件（而不是目录）上使用 fsPromises.rmdir() 会导致 promise 被拒绝，在 Windows 上使用 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 命令的行为，则使用具有选项 { recursive: true, force: true } 的 fsPromises.rm()。

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