fsPromises.rmdir(path[, options])

版本历史
版本变更
v12.16.0

选项 maxBusyTries 重命名为 maxRetries，默认值为 0。 选项 emfileWait 已删除，并且 EMFILE 错误使用与其他错误相同的重试逻辑。 现在支持 retryDelay 选项。 现在重试 ENFILE 错误。

v12.10.0

现在支持 recursive、maxBusyTries 和 emfileWait 选项。

v10.0.0

新增于: v10.0.0

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

  • path <string> | <Buffer> | <URL>
  • options <Object>
    • maxRetries <integer> 此选项表示重试次数。 如果 recursive 选项不为 true，则忽略此选项。 默认值: 0。
    • recursive <boolean> 如果为 true，则执行递归目录删除。 在递归模式下，当 path 不存在时不报错，当操作失败时则重试。 默认值: false。
    • retryDelay <integer> 重试之间等待的时间（以毫秒为单位）。 如果 recursive 选项不为 true，则忽略此选项。 默认值: 100。
  • 返回: <Promise>
History
VersionChanges
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

Added in: v10.0.0

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.
  • Returns: <Promise>

Removes the directory identified by path then resolves the Promise with no arguments upon success.

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.