FileSystemDirectoryHandle: getDirectoryHandle()-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 getDirectoryHandle()-Methode der FileSystemDirectoryHandle-Schnittstelle gibt ein FileSystemDirectoryHandle für ein Unterverzeichnis mit dem angegebenen Namen innerhalb des Verzeichnishandles zurück, auf dem die Methode aufgerufen wird.

Syntax

js
getDirectoryHandle(name)
getDirectoryHandle(name, options)

Parameter

name

Ein String, der den FileSystemHandle.name des Unterverzeichnisses darstellt, das Sie abrufen möchten.

options Optional

Ein optionales Objekt, das Optionen für das abgerufene Unterverzeichnis enthält. Die Optionen sind wie folgt:

create Optional

Ein boolescher Wert, der standardmäßig false ist. Wenn er auf true gesetzt wird und das Verzeichnis nicht gefunden wird, wird eines mit dem angegebenen Namen erstellt und zurückgegeben.

Rückgabewert

Ein Promise, das mit einem FileSystemDirectoryHandle aufgelöst wird.

Ausnahmen

NotAllowedError DOMException

Ausgelöst, wenn der PermissionStatus.state für das Handle nicht 'granted' im readwrite-Modus ist, wenn die create-Option auf true gesetzt ist, oder im read-Modus, wenn die create-Option auf false gesetzt ist.

TypeError

Ausgelöst, wenn der angegebene Name kein gültiger String ist oder Zeichen enthält, die mit dem nativen Dateisystem interferieren würden.

TypeMismatchError DOMException

Ausgelöst, wenn der zurückgegebene Eintrag eine Datei und kein Verzeichnis ist.

NotFoundError DOMException

Ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder wenn das Zielverzeichnis nicht existiert und die create-Option auf false gesetzt ist.

Beispiele

Das folgende Beispiel gibt ein Verzeichnishandle mit dem angegebenen Namen zurück. Falls das Verzeichnis nicht existiert, wird es erstellt.

js
const dirName = "directoryToGetName";

// assuming we have a directory handle: 'currentDirHandle'
const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true });

Spezifikationen

Specification
File System Standard
# api-filesystemdirectoryhandle-getdirectoryhandle

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch