FileSystemDirectoryHandle: entries() 方法

Baseline 已广泛支持

此功能已成熟，并可在许多设备和浏览器版本上运行。自 2023 年 3 月以来，它已在各种浏览器中可用。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

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

FileSystemDirectoryHandle 接口的 entries() 方法会返回一个新的异步迭代器，用于迭代调用该方法的 FileSystemDirectoryHandle 中各项的键值对。这些键值对的形式是 [key, value] 这样的数组。

语法

entries()

无。

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

NotAllowedError DOMException: 如果句柄的 PermissionStatus.state 在 read 模式下不是 'granted'，则会抛出此错误。
NotFoundError DOMException: 如果当前项未找到，则会抛出此错误。

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

const dirHandle = await window.showDirectoryPicker();

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

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

此页面最后修改于 2024年4月5日，由 MDN 贡献者更新。