FileSystemDirectoryHandle: Methode getDirectoryHandle()
Baseline 2023Newly 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 einen FileSystemDirectoryHandle für ein Unterverzeichnis mit dem angegebenen Namen innerhalb des Verzeichnis-Handles zurück, auf dem die Methode aufgerufen wird.
Syntax
getDirectoryHandle(name)
getDirectoryHandle(name, options)
Parameter
name-
Ein String, der den
FileSystemHandle.namedes gewünschten Unterverzeichnisses repräsentiert. optionsOptional-
Ein optionales Objekt, das Optionen für das abgerufene Unterverzeichnis enthält. Die Optionen sind wie folgt:
createOptional-
Ein boolescher Wert, der standardmäßig
falseist. Wenn auftruegesetzt, wird, falls das Verzeichnis nicht gefunden wird, eines mit dem angegebenen Namen erstellt und zurückgegeben.
Rückgabewert
Ein Promise, das mit einem FileSystemDirectoryHandle aufgelöst wird.
Ausnahmen
NotAllowedErrorDOMException-
Wird geworfen, wenn der
PermissionStatus.statefür das Handle nicht'granted'ist imreadwrite-Modus, wenn diecreate-Option auftruegesetzt ist, oder imread-Modus, wenn diecreate-Option auffalsegesetzt ist. TypeError-
Wird geworfen, wenn der angegebene Name kein gültiger String ist oder Zeichen enthält, die mit dem nativen Dateisystem interferieren würden.
TypeMismatchErrorDOMException-
Wird geworfen, wenn der zurückgegebene Eintrag eine Datei und kein Verzeichnis ist.
NotFoundErrorDOMException-
Wird geworfen, wenn der aktuelle Eintrag nicht gefunden wird oder wenn das Zielverzeichnis nicht existiert und die
create-Option auffalsegesetzt ist.
Beispiele
Das folgende Beispiel gibt ein Verzeichnis-Handle mit dem angegebenen Namen zurück. Wenn das Verzeichnis nicht existiert, wird es erstellt.
const dirName = "directoryToGetName";
// assuming we have a directory handle: 'currentDirHandle'
const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true });
Spezifikationen
| Specification |
|---|
| File System # api-filesystemdirectoryhandle-getdirectoryhandle |