FileSystemDirectoryHandle：entries() 方法

基线 2023

新可用

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

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

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

entries() 方法是 FileSystemDirectoryHandle 接口的方法，它返回一个新的异步迭代器，用于迭代在其上调用此方法的 FileSystemDirectoryHandle 中条目的键值对。键值对采用类似于 [key, value] 的数组形式。

语法

js
entries()

参数

无。

返回值

一个新的异步迭代器，包含 FileSystemDirectoryHandle 中每个条目的键值对。

异常

NotAllowedError DOMException

如果句柄的 PermissionStatus.state 不是 'granted'（读取模式），则抛出此异常。

NotFoundError DOMException

如果找不到当前条目，则抛出此异常。

示例

使用 for await...of 循环可以简化迭代过程。

js
const dirHandle = await window.showDirectoryPicker();

for await (const [key, value] of dirHandle.entries()) {
  console.log({ key, value });
}

规范

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

浏览器兼容性

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

另请参阅