FileSystemDirectoryHandle:removeEntry() 方法
Baseline 2023
Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
备注: 此特性在 Web Worker 中可用。
FileSystemDirectoryHandle
接口的 removeEntry()
方法用于尝试将目录句柄内指定名称的文件或目录移除。
语法
js
removeEntry(name)
removeEntry(name, options)
参数
name
-
一个字符串,表示你想要移除的条目的
FileSystemHandle.name
。 options
可选-
一个包含以下选项的可选对象:
recursive
可选-
布尔值,默认为
false
。当设为true
时,条目将会被递归移除。
返回值
一个 Promise
对象,兑现 undefined
。
异常
TypeError
-
如果 name 参数不是一个合法的字符串或者包含不允许出现在文件系统中的字符时,抛出此异常。
NotAllowedError
DOMException
-
如果句柄在
readwrite
模式下的PermissionStatus.state
不为'granted'
,抛出此异常。 InvalidModificationError
DOMException
-
如果
recursive
被设为false
,而对应的条目又有子条目时,抛出此异常。 NotFoundError
DOMException
-
如果没有找到指定名称的条目,抛出此异常。
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