FileSystemDirectoryHandle:removeEntry() 方法

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

FileSystemDirectoryHandle 接口的 removeEntry() 方法用于尝试将目录句柄内名为指定名称的文件或目录移除。

语法

js
removeEntry(name)
removeEntry(name, options)

参数

name

一个字符串,表示你想要移除的条目的 FileSystemHandle.name

options 可选

一个包含以下选项的可选对象:

recursive

布尔值,默认为 false。当设为 true 时,条目将会被递归移除。

返回值

一个 Promise 对象,兑现 undefined

异常

TypeError

如果 name 不是一个合法的字符串或者包含不允许出现在文件系统中的字符时,抛出此异常。

NotAllowedError DOMException

如果 PermissionStatus (en-US) 不为“granted”则抛出此异常。

InvalidModificationError DOMException

如果 recursive 被设为 false,而对应的条目又有子条目时,抛出此异常。

NotFoundError DOMException

如果没有找到指定名称的条目,抛出此异常。

示例

下面的示例演示移除目录句柄内的一个条目。

js
const entryName = "entryToRemove";

// 假设我们有一个目录句柄:'currentDirHandle'
currentDirHandle.removeEntry(entryName).then(() => {
  // 成功移除后要运行的代码
});

规范

Specification
File System Standard
# api-filesystemdirectoryhandle-removeentry

浏览器兼容性

BCD tables only load in the browser

参见