FileSystemDirectoryHandle:keys() 方法

基线 2023

新可用

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

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中可用。

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

keys() 方法是 FileSystemDirectoryHandle 接口的方法,它返回一个新的异步迭代器,用于迭代在其上调用此方法的 FileSystemDirectoryHandle 中的条目的键。

语法

js
keys()

参数

无。

返回值

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

异常

NotAllowedError DOMException

如果句柄的PermissionStatus.state 不是 '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

浏览器兼容性

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

另请参阅