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

版本历史

版本	变更
v25.0.0	Remove `recursive` option.
v18.0.0	Passing an invalid callback to the `callback` argument now throws `ERR_INVALID_ARG_TYPE` instead of `ERR_INVALID_CALLBACK`.
v16.0.0	Using `fs.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 `fs.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 `fs.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	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v7.6.0	The `path` parameters can be a WHATWG `URL` object using `file:` protocol.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v0.0.2	新增于: v0.0.2

path <string> | <Buffer> | <URL>
options <Object> 当前没有公开的选项。以前有 recursive、maxBusyTries 和 emfileWait 选项，但它们已被弃用并移除。options 参数仍然被接受以保持向后兼容，但它不再被使用。
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 命令的行为，请使用 fs.rm()，并设置选项 { recursive: true, force: true }。

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