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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
readAsText

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch