ContextQMD
Back to Content

FileSystemDirectoryHandle: values() method

files/en-us/web/api/filesystemdirectoryhandle/values/index.md

latest1.2 KB
Original Source

{{securecontext_header}}{{APIRef("File System API")}}{{AvailableInWorkers}}

The values() method of the {{domxref("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

js-nolint
values()

Parameters

None.

Return value

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

Exceptions

  • NotAllowedError {{domxref("DOMException")}}
    • : Thrown if the {{domxref('PermissionStatus.state')}} for the handle is not 'granted' in read mode.
  • NotFoundError {{domxref("DOMException")}}
    • : Thrown if the current entry is not found.

Examples

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

js
const dirHandle = await window.showDirectoryPicker();

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also