FileReaderSync: readAsArrayBuffer()-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 readAsArrayBuffer()-Methode der FileReaderSync-Schnittstelle ermöglicht das synchrone Lesen von File- oder Blob-Objekten in einen ArrayBuffer. Diese Schnittstelle ist nur verfügbar in Workers, da sie eine synchrone Ein-/Ausgabe ermöglicht, die potenziell blockierend sein könnte.

Syntax

js
readAsArrayBuffer(blob)

Parameter

blob

Die File oder der Blob, die in die File oder den ArrayBuffer gelesen werden soll.

Rückgabewert

Ein ArrayBuffer, der die Daten der Datei darstellt.

Ausnahmen

Die folgenden Ausnahmen können von dieser Methode ausgelöst werden:

NotFoundError DOMException

Wird ausgelöst, wenn die Ressource, die durch die 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 verändert;
  • es werden zu viele Lesevorgänge gleichzeitig durchgeführt;
  • die Datei, auf die die Ressource verweist, ist zur Nutzung im Web unsicher (z.B. weil sie eine Systemdatei ist).
NotReadableError DOMException

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

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch