FileReaderSync: Methode readAsText()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die readAsText()-Methode der FileReaderSync-Schnittstelle ermöglicht es Ihnen, File- oder Blob-Objekte auf synchronisierte Weise in eine Zeichenkette zu lesen. Diese Schnittstelle ist nur verfügbar in Workers, da sie synchrones I/O ermöglicht, das potenziell blockieren könnte.
Syntax
readAsText(blob)
readAsText(blob, encoding)
Parameter
blobencodingOptional-
Der optionale Parameter gibt die zu verwendende Kodierung an (z. B.
iso-8859-1oderUTF-8). Bei Abwesenheit wird die Methode einen Erkennungsalgorithmus hierfür anwenden.
Rückgabewert
Eine Zeichenkette, die die Eingabedaten darstellt.
Ausnahmen
Die folgende Ausnahmen können durch diese Methode ausgelöst werden:
NotFoundErrorDOMException-
Wird ausgelöst, wenn die Ressource, die durch die DOM-
FileoderBlobdargestellt wird, nicht gefunden werden kann, z. B. weil sie gelöscht wurde. SecurityErrorDOMException-
Wird ausgelöst, wenn eine der folgenden problematischen Situationen erkannt wird:
- die Ressource wurde von einem Dritten modifiziert;
- es werden zu viele Leseoperationen gleichzeitig durchgeführt;
- die Datei, auf die die Ressource verweist, ist unsicher für die Verwendung aus dem Web (wie zum Beispiel eine Systemdatei).
NotReadableErrorDOMException-
Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie zum Beispiel ein gleichzeitiges Sperren.
EncodingErrorDOMException-
Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längengrenze überschreitet.
Spezifikationen
| Spezifikation |
|---|
| File API # readAsTextSync |