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 January 2020.

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

blob: Die File oder der Blob, die gelesen werden sollen.
encoding Optional: Der optionale Parameter spezifiziert die zu verwendende Kodierung (z. B. iso-8859-1 oder UTF-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:

NotFoundError DOMException

Wird ausgelöst, wenn die durch die DOM-File oder den Blob dargestellte Ressource nicht gefunden werden kann, z. B. weil sie gelöscht wurde.

SecurityError DOMException

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).

NotReadableError DOMException

Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie z. B. einer gleichzeitigen Sperre.

EncodingError DOMException

Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längenbegrenzung überschreitet.

Spezifikationen

Specification
File API # readAsTextSync