path{string|Buffer|URL}options{Object}maxRetries{integer} 如果遇到EBUSY、EMFILE、ENFILE、ENOTEMPTY或EPERM错误,则 Node.js 会重试该操作(每次尝试时使用retryDelay毫秒时长的线性回退等待)。 此选项表示重试的次数。 如果recursive选项不为true,则此选项会被忽略。 默认值:0。recursive{boolean} 如果为true,则执行递归的目录删除。 在递归模式中,错误不会被报告(如果path不存在),并且操作会被重试(当失败时)。 默认值:false。retryDelay{integer} 重试之间等待的时间(以毫秒为单位)。 如果recursive选项不为true,则此选项会被忽略。 默认值:100。
- 返回: {Promise}
删除 path 指定的目录,然后在成功时解决 Promise 且不带参数。
对文件(而不是目录)使用 fsPromises.rmdir() 会导致 Promise 被拒绝,在 Windows 上会带上 ENOENT 错误、在 POSIX 上会带上 ENOTDIR 错误。
设置为 recursive 为 true 会导致行为类似于 Unix 命令 rm -rf:不存在的路径不会引发错误,表示文件的路径会被删除。
recursive 选项的宽容行为已弃用,未来会抛出 ENOTDIR 和 ENOENT。
