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'
inread
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 Standard # api-filesystemdirectoryhandle-asynciterable |
Browser compatibility
BCD tables only load in the browser