FileSystemDirectoryHandle: values() method

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The values() method of the FileSystemDirectoryHandle interface returns a new asynchronous iterator for the iteration of the value of the entries within the FileSystemDirectoryHandle on which this method is called.

Syntax

values()

Parameters

None.

Return value

A new asynchronous iterator containing the handles of each entry within the FileSystemDirectoryHandle.

Exceptions

NotAllowedError DOMException: Thrown if the PermissionStatus.state for the handle is not 'granted' in read mode.
NotFoundError DOMException: Thrown if the current entry is not found.

Examples

Use the for await...of loop can simplify the iteration process.

const dirHandle = await window.showDirectoryPicker();

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

Specifications

Specification
File System # api-filesystemdirectoryhandle-asynciterable