FileSystemDirectoryHandle:values() 方法

基线 2023

新可用

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

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

注意:此功能在Web 工作线程中可用。

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

语法

js
values()

参数

无。

返回值

包含 FileSystemDirectoryHandle 中每个条目的句柄的新的异步迭代器。

异常

NotAllowedError DOMException

如果句柄的 PermissionStatus.state 不是 'granted'(读取模式),则会抛出此异常。

NotFoundError DOMException

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

示例

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

js
const dirHandle = await window.showDirectoryPicker();

for await (const value of dirHandle.values()) {
  console.log(value);
}

规范

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

浏览器兼容性

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

另请参阅