FileReaderSync: readAsArrayBuffer() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist nur in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die readAsArrayBuffer()-Methode des FileReaderSync-Interfaces ermöglicht es Ihnen, File- oder Blob-Objekte synchron in einen ArrayBuffer zu lesen. Dieses Interface ist nur verfügbar in Workern, da es synchrones I/O ermöglicht, das potenziell blockieren könnte.
Syntax
readAsArrayBuffer(blob)
Parameter
blob-
Die
FileoderBlob, die in dieFileoder in denArrayBuffergelesen werden soll.
Rückgabewert
Ein ArrayBuffer, der die Daten der Datei darstellt.
Ausnahmen
Die folgenden Ausnahmen können durch diese Methode ausgelöst werden:
NotFoundErrorDOMException-
Wird ausgelöst, wenn die durch die DOM
FileoderBlobrepräsentierte Ressource nicht gefunden werden kann, z. B. weil sie gelöscht wurde. SecurityErrorDOMException-
Wird ausgelöst, wenn eine der folgenden problematischen Situationen erkannt wird:
- die Ressource wurde von einem Dritten modifiziert;
- es werden zu viele Lesevorgänge gleichzeitig durchgeführt;
- die Datei, auf die durch die Ressource verwiesen wird, ist für die Webnutzung unsicher (z. B. ist sie eine Systemdatei).
NotReadableErrorDOMException-
Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems, wie z. B. eines gleichzeitigen Zugriffs, nicht gelesen werden kann.
EncodingErrorDOMException-
Wird ausgelöst, wenn die Ressource eine Daten-URL ist und die von jedem Browser definierte Längenbegrenzung überschreitet.
Spezifikationen
| Spezifikation |
|---|
| File API # readAsArrayBufferSyncSection |