FileSystemDirectoryHandle: keys() 方法

Baseline 已广泛支持

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

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

FileSystemDirectoryHandle 接口的 keys() 方法会返回一个用于迭代调用此方法所在的 FileSystemDirectoryHandle 中条目键值的新异步迭代器。

语法

js
keys()

参数

无。

返回值

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

异常

NotAllowedError DOMException

如果句柄的 PermissionStatus.stateread 模式下不是 'granted',则会抛出此错误。

NotFoundError DOMException

如果当前项未找到,则会抛出此错误。

示例

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

js
const dirHandle = await window.showDirectoryPicker();

for await (const key of dirHandle.keys()) {
  console.log(key);
}

规范

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

浏览器兼容性

另见