File System API
FileSystemDirectoryHandle 接口的 removeEntry() 方法用于尝试将目录句柄内指定名称的文件或目录移除。
语法
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- : 如果未找到当前条目或者未找到或匹配特定名称的条目,抛出该异常。
示例
下面的示例演示移除目录句柄内的一个条目。
const entryName = "entryToRemove";
// 假设我们有一个目录句柄:“currentDirHandle”
currentDirHandle.removeEntry(entryName).then(() => {
// 成功移除后要运行的代码
});
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
