FileSystemDirectoryHandle：removeEntry() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

语法

js
removeEntry(name)
removeEntry(name, options)

参数

name

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

options 可选

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

recursive

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

返回值

一个 Promise 对象，兑现 undefined。

异常

TypeError

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

NotAllowedError DOMException

如果 PermissionStatus 不为“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

参见