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 des FileReaderSync-Interfaces ermöglicht das synchrone Lesen von File- oder Blob-Objekten in ein ArrayBuffer. Dieses Interface ist nur verfügbar in Arbeitern, da es synchrones I/O ermöglicht, das potenziell blockieren könnte.

Syntax

readAsArrayBuffer(blob)

Parameter

blob: Die File oder Blob, die in die File oder das ArrayBuffer gelesen werden soll.

Rückgabewert

Ein ArrayBuffer, das die Daten der Datei repräsentiert.

Ausnahmen

Die folgende Ausnahmen können durch diese Methode ausgelöst werden:

NotFoundError DOMException

Tritt auf, 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

Tritt auf, wenn eine der folgenden problematischen Situationen erkannt wird:

die Ressource wurde von einer Drittpartei modifiziert;
es werden gleichzeitig zu viele Lesevorgänge durchgeführt;
die durch die Ressource angezeigte Datei ist unsicher für die Verwendung aus dem Web (z.B. weil es sich um eine Systemdatei handelt).

NotReadableError DOMException

Tritt auf, wenn die Ressource aufgrund eines Berechtigungsproblems, wie einem konkurrierenden Sperren, nicht gelesen werden kann.

EncodingError DOMException

Tritt auf, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längenbegrenzung überschreitet.

Spezifikationen

Specification
File API # readAsArrayBufferSyncSection