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


稳定性: 1 - Recursive removal 是实验的。

  • path <string> | <Buffer> | <URL>
  • options <Object>
    • maxRetries <integer> 此选项表示重试次数。 如果 recursive 选项不为 true,则忽略此选项。 默认值: 0
    • recursive <boolean> 如果为 true,则执行递归目录删除。 在递归模式下,当 path 不存在时不报错,当操作失败时则重试。 默认值: false
    • retryDelay <integer> 重试之间等待的时间(以毫秒为单位)。 如果 recursive 选项不为 true,则忽略此选项。 默认值: 100
  • callback <Function>

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

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

Stability: 1 - Recursive removal is experimental.

  • path <string> | <Buffer> | <URL>
  • options <Object>
    • maxRetries <integer> If an EBUSY, EMFILE, ENFILE, ENOTEMPTY, or EPERM error is encountered, Node.js will retry the operation with a linear backoff wait of retryDelay ms longer on each try. This option represents the number of retries. This option is ignored if the recursive option is not true. Default: 0.
    • recursive <boolean> If true, perform a recursive directory removal. In recursive mode, errors are not reported if path does not exist, and operations are retried on failure. Default: false.
    • retryDelay <integer> The amount of time in milliseconds to wait between retries. This option is ignored if the recursive option is not true. Default: 100.
  • callback <Function>

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

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