FileReader

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das FileReader-Interface ermöglicht es Webanwendungen, den Inhalt von Dateien (oder Rohdatenpuffern), die auf dem Computer des Benutzers gespeichert sind, asynchron zu lesen. Dafür werden File- oder Blob-Objekte verwendet, um die Datei oder die zu lesenden Daten anzugeben.

Dateiobjekte können aus einem FileList-Objekt gewonnen werden, das als Ergebnis einer Benutzerauswahl von Dateien über das <input>-Element oder aus einem DataTransfer-Objekt bei einem Drag-and-Drop-Vorgang zurückgegeben wird.

FileReader kann nur auf den Inhalt von Dateien zugreifen, die der Benutzer ausdrücklich ausgewählt hat, entweder über ein HTML-<input type="file">-Element oder per Drag-and-Drop. Es kann nicht verwendet werden, um eine Datei über ihren Pfadnamen aus dem Dateisystem des Benutzers zu lesen. Um Dateien im Dateisystem des Clients über den Pfadnamen zu lesen, verwenden Sie die File System Access API. Um serverseitige Dateien zu lesen, verwenden Sie fetch(), mit CORS-Berechtigung, wenn Sie plattformübergreifend lesen.

Konstruktor

FileReader(): Gibt ein neues FileReader-Objekt zurück.

Siehe Verwendung von Dateien aus Webanwendungen für Details und Beispiele.

Instanzeigenschaften

FileReader.error Schreibgeschützt

Ein DOMException, das den aufgetretenen Fehler beim Lesen der Datei darstellt.

FileReader.readyState Schreibgeschützt

Eine Zahl, die den Zustand des FileReader angibt. Dies ist einer der folgenden Werte:

Name	Wert	Beschreibung
`EMPTY`	`0`	Es wurden noch keine Daten geladen.
`LOADING`	`1`	Daten werden gerade geladen.
`DONE`	`2`	Der gesamte Lesevorgang wurde abgeschlossen.

FileReader.result Schreibgeschützt

Der Inhalt der Datei. Diese Eigenschaft ist nur nach Abschluss der Leseoperation gültig und das Datenformat hängt davon ab, welche Methoden zur Initiierung der Leseoperation verwendet wurden.

Instanzmethoden

FileReader.abort(): Bricht die Leseoperation ab. Nach der Rückkehr wird readyState auf DONE gesetzt.
FileReader.readAsArrayBuffer(): Beginnt das Lesen des Inhalts des angegebenen Blob. Nach Abschluss enthält das result-Attribut ein ArrayBuffer, das die Daten der Datei darstellt.
FileReader.readAsBinaryString() Veraltet: Beginnt das Lesen des Inhalts des angegebenen Blob. Nach Abschluss enthält das result-Attribut die Roh-Binärdaten der Datei als String.
FileReader.readAsDataURL(): Beginnt das Lesen des Inhalts des angegebenen Blob. Nach Abschluss enthält das result-Attribut eine data:-URL, die die Daten der Datei darstellt.
FileReader.readAsText(): Beginnt das Lesen des Inhalts des angegebenen Blob. Nach Abschluss enthält das result-Attribut den Inhalt der Datei als Textstring. Ein optionaler Codierungsname kann angegeben werden.

Ereignisse

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Entfernen Sie die Event-Listener mit removeEventListener(), sobald FileReader nicht mehr verwendet wird, um Speicherverluste zu vermeiden.

abort: Wird ausgelöst, wenn ein Lesevorgang abgebrochen wurde, zum Beispiel weil das Programm FileReader.abort() aufgerufen hat.
error: Wird ausgelöst, wenn das Lesen aufgrund eines Fehlers fehlgeschlagen ist.
load: Wird ausgelöst, wenn ein Lesevorgang erfolgreich abgeschlossen wurde.
loadend: Wird ausgelöst, wenn ein Lesevorgang abgeschlossen wurde, unabhängig davon, ob erfolgreich oder nicht.
loadstart: Wird ausgelöst, wenn ein Lesevorgang gestartet wurde.
progress: Wird regelmäßig ausgelöst, während Daten gelesen werden.

Spezifikationen

Specification
File API # APIASynch

Browser-Kompatibilität

BCD tables only load in the browser