Baseline 2023
Newly available
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.
getDirectoryHandle(name)
getDirectoryHandle(name, options)
Parameter
name
Ein String, der den FileSystemHandle.name
des gewünschten Unterverzeichnisses repräsentiert.
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 auf true
gesetzt, wird, falls das Verzeichnis nicht gefunden wird, eines mit dem angegebenen Namen erstellt und zurückgegeben.
Ein Promise
, das mit einem FileSystemDirectoryHandle
aufgelöst wird.
NotAllowedError
DOMException
Wird geworfen, wenn der PermissionStatus.state
für das Handle nicht 'granted'
ist im readwrite
-Modus, wenn die create
-Option auf true
gesetzt ist, oder im read
-Modus, wenn die create
-Option auf false
gesetzt 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.
TypeMismatchError
DOMException
Wird geworfen, wenn der zurückgegebene Eintrag eine Datei und kein Verzeichnis ist.
NotFoundError
DOMException
Wird geworfen, wenn der aktuelle Eintrag nicht gefunden wird oder wenn das Zielverzeichnis nicht existiert und die create
-Option auf false
gesetzt ist.
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 Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4