FileSystemDirectoryHandle: keys() 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 keys()-Methode der FileSystemDirectoryHandle-Schnittstelle gibt einen neuen asynchronen Iterator zurück, um die Schlüssel der Einträge innerhalb des FileSystemDirectoryHandle, auf dem diese Methode aufgerufen wird, zu iterieren.

Syntax

js
keys()

Parameter

Keine.

Rückgabewert

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

Ausnahmen

NotAllowedError DOMException

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

NotFoundError DOMException

Wird 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 key of dirHandle.keys()) {
  console.log(key);
}

Spezifikationen

Specification
File System Standard
# api-filesystemdirectoryhandle-asynciterable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch