FileReaderSync: readAsText()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die readAsText()-Methode der FileReaderSync-Schnittstelle ermöglicht das synchrone Auslesen von File- oder Blob-Objekten in einen String. Diese Schnittstelle ist nur verfügbar in Workern, da sie synchronen I/O ermöglicht, der potenziell blockieren könnte.
Syntax
readAsText(blob)
readAsText(blob, encoding)
Parameter
blobencodingOptional-
Der optionale Parameter spezifiziert die zu verwendende Kodierung (z. B.
iso-8859-1oderUTF-8). Wenn nicht vorhanden, wird die Methode einen Erkennungsalgorithmus anwenden.
Rückgabewert
Ein String, der die Eingabedaten darstellt.
Ausnahmen
Die folgende Ausnahmen können von dieser Methode ausgelöst werden:
NotFoundErrorDOMException-
Wird ausgelöst, wenn die durch die DOM-
Fileoder denBlobdargestellte Ressource 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 einer dritten Partei verändert;
- es werden zu viele Lesevorgänge gleichzeitig durchgeführt;
- die durch die Ressource angegebene Datei ist unsicher für eine Verwendung im Web (z. B. handelt es sich um eine Systemdatei).
NotReadableErrorDOMException-
Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie z. B. einer gleichzeitigen Sperre.
EncodingErrorDOMException-
Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längenbegrenzung überschreitet.
Spezifikationen
| Specification |
|---|
| File API # readAsTextSync |
Browser-Kompatibilität
Loading…