FileSystemDirectoryHandle: entries() method
{{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
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'inreadmode.
- : Thrown if the
NotFoundError{{domxref("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 [key, value] of dirHandle.entries()) {
console.log({ key, value });
}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}