FileSystemDirectoryHandle：removeEntry() 方法

基线 2023

新可用

自 2023 年 3 月起，此功能可在最新的设备和浏览器版本上运行。此功能可能无法在旧版设备或浏览器上运行。

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中。

注意：此功能在Web Workers中可用。

removeEntry() 方法是 FileSystemDirectoryHandle 接口的方法，如果目录句柄包含名为指定名称的文件或目录，则尝试删除该条目。

语法

js
removeEntry(name)
removeEntry(name, options)

参数

name

一个字符串，表示要删除的条目的FileSystemHandle.name。

options 可选

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

recursive 可选

一个布尔值，默认为 false。设置为 true 时，将递归删除条目。

返回值

一个Promise，解析为 undefined。

异常

TypeError

如果名称不是有效的字符串或包含文件系统不允许的字符，则抛出。

NotAllowedError DOMException

如果句柄的PermissionStatus.state 不是 'granted' 且处于 readwrite 模式，则抛出。

InvalidModificationError DOMException

如果 recursive 设置为 false 且要删除的条目有子项，则抛出。

NotFoundError DOMException

如果当前条目未找到或未找到或匹配指定名称的条目，则抛出。

示例

以下示例删除目录句柄中的一个条目。

js
const entryName = "entryToRemove";

// assuming we have a directory handle: 'currentDirHandle'
currentDirHandle.removeEntry(entryName).then(() => {
  // code to run if removing was successful
});

规范

规范
文件系统标准
# api-filesystemdirectoryhandle-removeentry

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅