FileSystemDirectoryHandle: `entries()`-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: Diese Funktion ist in Web Workers verfügbar.

Die entries()-Methode der FileSystemDirectoryHandle-Schnittstelle gibt einen neuen asynchronen Iterator für die Iteration der Schlüssel-Wert-Paare der Einträge innerhalb des FileSystemDirectoryHandle zurück, auf dem diese Methode aufgerufen wird. Die Schlüssel-Wert-Paare haben die Form eines Arrays wie [key, value].

Syntax

js
entries()

Parameter

Keine.

Rückgabewert

Ein neuer asynchroner Iterator, der die Schlüssel-Wert-Paare 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, value] of dirHandle.entries()) {
  console.log({ key, value });
}

Spezifikationen

Specification
File System Standard
# api-filesystemdirectoryhandle-asynciterable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch