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
readAsText(blob)
readAsText(blob, encoding)
Parameter
blob
encoding
Optional-
Der optionale Parameter gibt die zu verwendende Kodierung an (z.B.
iso-8859-1
oderUTF-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 denBlob
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