Home Original page

FileSystemFileHandle: getFile()-Methode - Web-APIs | MDN

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 getFile()-Methode der FileSystemFileHandle-Schnittstelle gibt ein Promise zurück, das bei Erfüllung ein File-Objekt liefert, das den aktuellen Zustand des auf der Festplatte gespeicherten Eintrags repräsentiert, der durch den Handle dargestellt wird.

Wenn die Datei auf der Festplatte nach dem Aufruf dieser Methode geändert oder entfernt wird, ist das zurückgegebene File-Objekt wahrscheinlich nicht mehr lesbar.

Syntax

Parameter

Keine.

Rückgabewert

Ein Promise, das bei Erfüllung ein File-Objekt liefert.

Ausnahmen

NotAllowedError DOMException

Wird ausgelöst, wenn der PermissionStatus.state nicht auf granted im read-Modus gesetzt ist.

NotFoundError DOMException

Wird ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird.

Beispiele

Die folgende asynchrone Funktion zeigt einen Dateiauswahldialog und verwendet, nachdem eine Datei ausgewählt wurde, die getFile()-Methode, um den Inhalt abzurufen.

js

async function getTheFile() {
  // open file picker
  const [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // get file contents
  const fileData = await fileHandle.getFile();
}

Spezifikationen

Spezifikation
File System
# api-filesystemfilehandle-getfile

Browser-Kompatibilität

Siehe auch

Help improve MDN

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