FileSystemDirectoryHandle: getDirectoryHandle()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
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 liefert ein
FileSystemDirectoryHandle für ein Unterverzeichnis mit dem angegebenen Namen innerhalb des Verzeichnisses, auf dem die Methode aufgerufen wird.
Syntax
getDirectoryHandle(name)
getDirectoryHandle(name, options)
Parameter
name-
Ein String, der den
FileSystemHandle.namedes Unterverzeichnisses repräsentiert, das Sie abrufen möchten. 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 er auftruegesetzt ist 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
NotAllowedErrorDOMException-
Wird ausgelöst, 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 ausgelöst, wenn der angegebene Name kein gültiger String ist oder Zeichen enthält, die mit dem nativen Dateisystem interferieren würden.
TypeMismatchErrorDOMException-
Wird ausgelöst, wenn der zurückgegebene Eintrag eine Datei und kein Verzeichnis ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder wenn das Zielverzeichnis nicht existiert und die
create-Option auffalsegesetzt ist.
Beispiele
Das folgende Beispiel liefert ein Verzeichnis-Handle mit dem angegebenen Namen, falls das Verzeichnis nicht existiert, wird es erstellt.
const dirName = "directoryToGetName";
// assuming we have a directory handle: 'currentDirHandle'
const subDir = await currentDirHandle.getDirectoryHandle(dirName, {
create: true,
});
Spezifikationen
| Specification |
|---|
| File System # api-filesystemdirectoryhandle-getdirectoryhandle |
Browser-Kompatibilität
Loading…