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 wird zugunsten von readAsArrayBuffer() als veraltet angesehen.

Die readAsBinaryString() Methode der FileReaderSync Schnittstelle ermöglicht das synchrone Lesen von File oder Blob Objekten in einen String. Diese Schnittstelle ist nur verfügbar in 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

Ein String, der die Eingabedaten darstellt.

Ausnahmen

NotFoundError DOMException

Wird ausgelöst, wenn die durch die DOM File oder Blob dargestellte Ressource 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 verändert;
  • Es werden zu viele Leseoperationen gleichzeitig durchgeführt;
  • Die Datei, auf die die Ressource verweist, ist unsicher für eine Web-Nutzung (wie z. B. eine Systemdatei).
NotReadableError DOMException

Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie z. B. ein gleichzeitiges Sperren.

EncodingError DOMException

Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längenbeschränkung überschreitet.

Spezifikationen

Specification
File API
# readAsBinaryStringSyncSection

Browser-Kompatibilität

Siehe auch