FileSystemDirectoryHandle: Methode getFileHandle()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.

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.

In diesem Artikel

Syntax

js
getFileHandle(name)
getFileHandle(name, options)

Parameter

name

Ein String, der den FileSystemHandle.name der Datei darstellt, die Sie abrufen möchten.

options Optional

Ein Objekt mit den folgenden Eigenschaften:

create Optional

Ein Boolean. Standard ist false. Wenn auf true gesetzt, 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

NotAllowedError DOMException

Wird ausgelöst, wenn der PermissionStatus.state für den Handle in readwrite-Modus nicht 'granted' ist, wenn die create-Option auf true gesetzt ist, oder im read-Modus, wenn die create-Option auf false gesetzt 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.

TypeMismatchError DOMException

Wird ausgelöst, wenn der benannte Eintrag ein Verzeichnis und keine Datei ist.

NotFoundError DOMException

Wird ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder die Datei nicht existiert und die create-Option auf false gesetzt ist.

Beispiele

Das folgende Beispiel gibt einen Dateihandle mit dem angegebenen Namen zurück. Wenn die Datei nicht existiert, wird sie erstellt.

js
const fileName = "fileToGetName";

// assuming we have a directory handle: 'currentDirHandle'
const fileHandle = await currentDirHandle.getFileHandle(fileName, {
  create: true,
});

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

File System API
FileSystemDirectoryHandle
Instanzmethoden
Vererbung
1. FileSystemHandle
Verwandte Seiten für File System API
Anleitungen
1. Origin-Privates-Dateisystem