FileSystemDirectoryHandle:removeEntry() 方法
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年3月.
备注: 此特性在 Web Worker 中可用。
FileSystemDirectoryHandle 接口的 removeEntry() 方法用于尝试将目录句柄内指定名称的文件或目录移除。
语法
js
removeEntry(name)
removeEntry(name, options)
参数
name-
一个字符串,表示你想要移除的条目的
FileSystemHandle.name。 options可选-
一个包含以下选项的可选对象:
recursive可选-
布尔值,默认为
false。当设为true时,条目将会被递归移除。
返回值
一个 Promise 对象,兑现 undefined。
异常
TypeError-
如果 name 参数不是一个合法的字符串或者包含不允许出现在文件系统中的字符时,抛出此异常。
NotAllowedErrorDOMException-
如果句柄在
readwrite模式下的PermissionStatus.state不为'granted',抛出此异常。 InvalidModificationErrorDOMException-
如果
recursive被设为false,而对应的条目又有子条目时,抛出此异常。 NotFoundErrorDOMException-
如果没有找到指定名称的条目,抛出此异常。
NotFoundErrorDOMException-
如果未找到当前条目或者未找到或匹配特定名称的条目,抛出该异常。
示例
下面的示例演示移除目录句柄内的一个条目。
js
const entryName = "entryToRemove";
// 假设我们有一个目录句柄:“currentDirHandle”
currentDirHandle.removeEntry(entryName).then(() => {
// 成功移除后要运行的代码
});
规范
| Specification |
|---|
| File System> # api-filesystemdirectoryhandle-removeentry> |
浏览器兼容性
Loading…