FileReaderSync: readAsBinaryString()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Hinweis: Dieses Feature ist nur verfügbar in Web Workers, außer in 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