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: Dieses Feature ist verfügbar in Web Workers.
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
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 auftrue
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'
imreadwrite
-Modus ist, wenn diecreate
-Option auftrue
gesetzt ist, oder imread
-Modus, wenn diecreate
-Option auffalse
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 auffalse
gesetzt ist.
Beispiele
Das folgende Beispiel gibt ein Verzeichnishandle mit dem angegebenen Namen zurück. Falls 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 Standard # api-filesystemdirectoryhandle-getdirectoryhandle |
Browser-Kompatibilität
BCD tables only load in the browser