FileSystemDirectoryHandle: Methode getFileHandle()
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 getFileHandle()-Methode der FileSystemDirectoryHandle-Schnittstelle gibt ein FileSystemFileHandle für eine Datei mit dem angegebenen Namen innerhalb des Verzeichnisses zurück, in dem die Methode aufgerufen wird.
Syntax
getFileHandle(name)
getFileHandle(name, options)
Parameter
name-
Ein String, der den
FileSystemHandle.nameder Datei darstellt, die Sie abrufen möchten. optionsOptional-
Ein Objekt mit den folgenden Eigenschaften:
createOptional-
Ein
Boolean. Standard istfalse. Wenn auftruegesetzt, wird eine Datei mit dem angegebenen Namen erstellt und zurückgegeben, falls die Datei nicht gefunden wird.
Rückgabewert
Ein Promise, der mit einem FileSystemFileHandle aufgelöst wird.
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn der
PermissionStatus.statefür den Handle inreadwrite-Modus nicht'granted'ist, 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 kollidieren würden.
TypeMismatchErrorDOMException-
Wird ausgelöst, wenn der benannte Eintrag ein Verzeichnis und keine Datei ist.
NotFoundErrorDOMException-
Wird ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder die Datei nicht existiert und die
create-Option auffalsegesetzt ist.
Beispiele
Das folgende Beispiel gibt einen Dateihandle mit dem angegebenen Namen zurück. Wenn die Datei nicht existiert, wird sie erstellt.
const fileName = "fileToGetName";
// assuming we have a directory handle: 'currentDirHandle'
const fileHandle = await currentDirHandle.getFileHandle(fileName, {
create: true,
});
Spezifikationen
| Specification |
|---|
| File System # api-filesystemdirectoryhandle-getfilehandle |
Browser-Kompatibilität
Loading…