fs.rmdir(path[, options], callback)
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
。
callback
<Function>err
<Error>
异步的 rmdir(2)
。
除了可能的异常之外,没有为完成回调提供任何参数。
在文件(而不是目录)上使用 fs.rmdir()
,则在 Windows 上会导致 ENOENT
错误,在 POSIX 上会导致 ENOTDIR
错误。
要获得类似于 rm -rf
Unix 命令的行为,则使用具有选项 { recursive: true, force: true }
的 fs.rm()
。
path
<string> | <Buffer> | <URL>options
<Object>maxRetries
<integer> If anEBUSY
,EMFILE
,ENFILE
,ENOTEMPTY
, orEPERM
error is encountered, Node.js retries the operation with a linear backoff wait ofretryDelay
milliseconds longer on each try. This option represents the number of retries. This option is ignored if therecursive
option is nottrue
. Default:0
.recursive
<boolean> Iftrue
, perform a recursive directory removal. In recursive mode, operations are retried on failure. Default:false
. Deprecated.retryDelay
<integer> The amount of time in milliseconds to wait between retries. This option is ignored if therecursive
option is nottrue
. Default:100
.
callback
<Function>err
<Error>
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.
To get a behavior similar to the rm -rf
Unix command, use fs.rm()
with options { recursive: true, force: true }
.