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

js
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

Siehe auch