FileSystemDirectoryHandle: values()-Methode

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die values()-Methode des FileSystemDirectoryHandle-Interfaces gibt einen neuen asynchronen Iterator zur Iteration der Werte der Einträge innerhalb des FileSystemDirectoryHandle zurück, auf dem diese Methode aufgerufen wird.

Syntax

js
values()

Parameter

Keine.

Rückgabewert

Ein neuer asynchroner Iterator, der die Handles jedes Eintrags innerhalb des FileSystemDirectoryHandle enthält.

Ausnahmen

NotAllowedError DOMException

Ausgelöst, wenn der PermissionStatus.state für das Handle im read-Modus nicht 'granted' ist.

NotFoundError DOMException

Ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird.

Beispiele

Die Verwendung der for await...of-Schleife kann den Iterationsprozess vereinfachen.

js
const dirHandle = await window.showDirectoryPicker();

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

Spezifikationen

Specification
File System Standard
# api-filesystemdirectoryhandle-asynciterable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch