fs.rmdir(path[, options], callback)

版本历史

版本	变更
v25.0.0	删除 `recursive` 选项。
v18.0.0	将无效回调传给 `callback` 参数现在会抛出 `ERR_INVALID_ARG_TYPE` 而不是 `ERR_INVALID_CALLBACK`。
v16.0.0	不再允许在作为文件的 `path` 上使用 `fs.rmdir(path, { recursive: true })`，这会在 Windows 上导致 `ENOENT` 错误，在 POSIX 上导致 `ENOTDIR` 错误。
v16.0.0	不再允许在不存在的 `path` 上使用 `fs.rmdir(path, { recursive: true })`，这会导致 `ENOENT` 错误。
v16.0.0	选项 `recursive` 已弃用，使用它会触发弃用警告。
v14.14.0	不推荐使用 `recursive` 选项，请改用 `fs.rm`。
v13.3.0, v12.16.0	选项 `maxBusyTries` 重命名为 `maxRetries`，默认值为 0。选项 `emfileWait` 已删除，并且 `EMFILE` 错误使用与其他错误相同的重试逻辑。现在支持 `retryDelay` 选项。现在重试 `ENFILE` 错误。
v12.10.0	现在支持 `recursive`、`maxBusyTries` 和 `emfileWait` 选项。
v10.0.0	参数 `callback` 不再是可选的。不传入它会在运行时抛出 `TypeError`。
v7.6.0	参数 `path` 可以是使用 `file:` 协议的 WHATWG `URL` 对象。
v7.0.0	参数 `callback` 不再是可选的。不传入它将触发 ID 为 DEP0013 的弃用警告。
v0.0.2	新增于: v0.0.2

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.
callback <Function>
- err <Error>

异步 rmdir(2)。除了可能的异常之外，没有为完成回调提供任何参数。

¥Asynchronous rmdir(2). No arguments other than a possible exception are given to the completion callback.

在文件（而不是目录）上使用 fs.rmdir()，则在 Windows 上会导致 ENOENT 错误，在 POSIX 上会导致 ENOTDIR 错误。

¥Using fs.rmdir() on a file (not a directory) results in an ENOENT error on Windows and an ENOTDIR error on POSIX.

要获得类似于 rm -rf Unix 命令的行为，则使用具有选项 { recursive: true, force: true } 的 fs.rm()。

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