FileSystemFileHandle: getFile()-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 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
getFile()
Parameter
Keine.
Rückgabewert
Ausnahmen
NotAllowedError
DOMException
-
Wird ausgelöst, wenn der
PermissionStatus.state
nicht aufgranted
imread
-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.
async function getTheFile() {
// open file picker
const [fileHandle] = await window.showOpenFilePicker(pickerOpts);
// get file contents
const fileData = await fileHandle.getFile();
}
Spezifikationen
Specification |
---|
File System Standard # api-filesystemfilehandle-getfile |
Browser-Kompatibilität
BCD tables only load in the browser