FileReaderSync: readAsText()-Methode

Hinweis: Dieses Feature ist nur verfügbar in Web Workers, außer in Service Workers.

Die readAsText()-Methode der FileReaderSync-Schnittstelle ermöglicht das synchrone Lesen von File- oder Blob-Objekten in eine Zeichenkette. Diese Schnittstelle ist nur verfügbar in Workers, da sie synchrone I/O-Operationen ermöglicht, die potenziell blockierend sein könnten.

Syntax

readAsText(blob)
readAsText(blob, encoding)

Parameter

blob: Die zu lesende File oder der zu lesende Blob.
encoding Optional: Der optionale Parameter gibt die zu verwendende Kodierung an (z.B. iso-8859-1 oder UTF-8). Wenn er nicht vorhanden ist, wird die Methode einen Erkennungsalgorithmus anwenden.

Rückgabewert

Eine Zeichenkette, die die Eingabedaten repräsentiert.

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 repräsentierte Ressource nicht gefunden werden kann, z.B., weil sie gelöscht wurde.

SecurityError DOMException

Wird ausgelöst, wenn eine der folgenden problematischen Situationen festgestellt wird:

Die Ressource wurde von einem Dritten verändert;
zu viele Lesevorgänge werden gleichzeitig durchgeführt;
die Datei, auf die die Ressource verweist, ist unsicher für eine Nutzung aus dem Web (wie z.B. eine Systemdatei).

NotReadableError DOMException

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

EncodingError DOMException

Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die durch jeden Browser definierte Längenbeschränkung überschreitet.

Spezifikationen

Specification
File API # readAsTextSync

Browser-Kompatibilität

BCD tables only load in the browser