FileReaderSync: readAsBinaryString()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Hinweis: Diese Funktion ist nur in Web Workers verfügbar, mit Ausnahme von Service Workers.

Hinweis: Diese Methode ist zugunsten von readAsArrayBuffer() veraltet.

Die readAsBinaryString()-Methode des FileReaderSync-Interfaces ermöglicht es, File- oder Blob-Objekte synchron in eine Zeichenkette zu lesen. Diese Schnittstelle ist nur verfügbar in Web Workern, da sie synchrones I/O ermöglicht, das potenziell blockieren könnte.

Syntax

js
readAsBinaryString(blob)

Parameter

blob

Die zu lesende File oder Blob.

Rückgabewert

Eine Zeichenkette, die die Eingabedaten repräsentiert.

Ausnahmen

NotFoundError DOMException

Wird ausgelöst, wenn die Ressource, die durch das DOM-File oder Blob repräsentiert wird, 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 einem Dritten geändert;
  • es werden gleichzeitig zu viele Lesevorgänge durchgeführt;
  • die durch die Ressource angezeigte Datei ist unsicher für die Verwendung im Web (z. B. eine Systemdatei).
NotReadableError DOMException

Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems, wie einem gleichzeitigen Sperren, nicht gelesen werden kann.

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch