ContextQMD
Back to Content

FileSystemDirectoryHandle: entries() method

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

latest1.3 KB
Original Source

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

The entries() method of the {{domxref("FileSystemDirectoryHandle")}} interface returns a new asynchronous iterator for the iteration of the key-value pairs of the entries within the FileSystemDirectoryHandle on which this method is called. The key-value pairs are in the form of an array like [key, value].

Syntax

js-nolint
entries()

Parameters

None.

Return value

A new asynchronous iterator containing the key-value pairs 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 [key, value] of dirHandle.entries()) {
  console.log({ key, value });
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also