fs.rmdirSync(path[, options])

版本历史
版本变更
v16.0.0

Using fs.rmdirSync(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.rmdirSync(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.rmSync 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.

v7.6.0

The path parameters can be a WHATWG URL object using file: protocol.

v0.1.21

新增于: v0.1.21

  • path <string> | <Buffer> | <URL>
  • options <Object>
    • maxRetries <integer> 如果遇到 EBUSY、EMFILE、ENFILE、ENOTEMPTY 或 EPERM 错误，Node.js 会以线性递增的方式重试操作，每次重试等待时间比上一次增加 retryDelay 毫秒。此选项表示重试的次数。如果 recursive 选项不是 true，则会忽略此选项。默认值： 0。
    • recursive <boolean> 如果 true，执行递归目录删除。在递归模式下，操作失败时会重试。默认值： false。已弃用。
    • retryDelay <integer> 在重试之间等待的时间（毫秒）。如果 recursive 选项不是 true，则会忽略此选项。默认值： 100。

同步 rmdir(2)。返回 undefined。

🌐 Synchronous rmdir(2). Returns undefined.

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

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

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

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