FileReader

Mit dem FileReader-Objekt k├Ânnen Webapplikationen den Inhalt von auf dem Computer des Benutzers gespeicherten Dateien (oder Rohdaten-Buffer) asynchron lesen. Mit File oder Blob-Objekten wird die zu lesende Datei oder die zu lesenden Daten spezifiziert.

File Objekte k├Ânnen ├╝ber ein FileList Objekt erhalten werden, welches als Ergebnis einer Dateiauswahl durch einen Benutzer ├╝ber das <input> Element zur├╝ckgegeben wird. Weitere m├Âgliche Quellen sind drag and drop Ereignisse ├╝ber ein DataTransfer Objekt oder ├╝ber die mozGetAsFile() API des HTMLCanvasElement.

Konstruktor

FileReader FileReader();

Im Kapitel Zugriff auf Dateien von Webapplikationen finden sich weitere Details und Beispiele.

Eigenschaften

FileReader.error Read only
Ein DOMError, der den Fehler angibt, welcher beim Lesen der Datei entstanden ist.
FileReader.readyState Read only
Eine Zahl, welche den Status des FileReader angibt. M├Âglich ist eine der Status-Konstanten.
FileReader.result Read only
Der Inhalt der Datei. Diese Eigenschaft ist nur g├╝ltig, nachdem der Lesevorgang abgeschlossen ist. Das Format der Daten h├Ąngt davon ab, welche der Methoden zum Starten des Lesevorgangs benutzt wurde.

Event-Handler

FileReader.onabort
Ein Handler f├╝r das abort-Event. Dieser Event wird gefeuert, wenn der Lesevorgang abgebrochen wird.
FileReader.onerror
Ein Handler f├╝r das error-Event. Dieser Event wird gefeuert, wenn beim Lesevorgang ein Fehler ensteht.
FileReader.onload
Ein Handler f├╝r das load-Event. Dieser Event wird gefeuert, wenn der Lesevorgang erfolgreich beendet wird.
FileReader.onloadstart
Ein Handler f├╝r das loadstart-Event. Dieser Event wird gefeuert, wenn der Lesevorgang gestartet wird.
FileReader.onloadend
Ein Handler f├╝r das loadend-Event. Dieser Event wird gefeuert, wenn der Lesevorgang beendet wird (entweder erfolgreich oder fehlerhaft).
FileReader.onprogress
Ein Handler f├╝r das progress-Event. Dieser Event wird gefeuert, w├Ąhrend ein Blob-Inhalt gelesen wird.

Hinweis: DaFileReader von EventTarget erbt, kann auf alle diese Events auch mit der addEventListener Methode geh├Ârt werden.

Status-Konstanten

  • EMPTY : 0 : Noch keine Daten geladen.
  • LOADING : 1 : Daten werden geladen.
  • DONE : 2 : Der Lesevorgang ist abgeschlossen.

Methoden

FileReader.abort()
Bricht den Lesevorgang ab. Nach dem Return wird der readyState zu DONE.
FileReader.readAsArrayBuffer()
Startet den Lesevorgang und liest den spezifierten Blob und, wenn der Lesevorgang abgeschlossen ist, enth├Ąlt result ein ArrayBuffer mit den Daten.
FileReader.readAsBinaryString()
Startet den Lesevorgang und liest den spezifierten Blob und, wenn der Lesevorgang abgeschlossen ist, enth├Ąlt result die rohen Bin├Ąr-Daten als String.
FileReader.readAsDataURL()
Startet den Lesevorgang und liest den spezifierten Blob und, wenn der Lesevorgang abgeschlossen ist, enth├Ąlt result die Daten als Data-URL.
FileReader.readAsText()
Startet den Lesevorgang und liest den spezifierten Blob und , wenn der Lesevorgang abgeschlossen ist, enth├Ąlt result die Daten als Text-String.

Spezifikationen

Spezifikation Status Kommentar
File API
Die Definition von 'FileReader' in dieser Spezifikation.
Arbeitsentwurf Initial definition

Browser-Kompatiblit├Ąt

Wir konvertieren die Kompatibilit├Ątsdaten in ein maschinenlesbares JSON Format. Diese Kompatibilit├Ątstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst!

Feature Firefox (Gecko) Chrome Internet Explorer Opera Safari
Basissupport 3.6 (1.9.2)[1] 7 10[2] 12.02[3] 6.0.2
Feature Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Basissupport 32 3 10 11.5 6.1

[1] Vor Gecko 2.0 beta 7 (Firefox 4.0 beta 7), waren alle Blob parameters stattdessen File Parameter; Das wurde aktualisiert um die Spezifikation zu erf├╝llen. Vor Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) gab die FileReader.error Eigenschaft ein  FileError Objekt zur├╝ck. Dieses Interface wurde wurde entfernt und FileReader.error gibt nun einen DOMError Objekt zur├╝ck, wie in dem aktuellen FileAPI Entwurf vorgesehen.

[2] IE9 hat ein File API Lab.

[3] Opera hat partiellen Support in 11.1.

Siehe auch