FileReaderSync: Methode readAsDataURL()

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 readAsDataURL() Methode des FileReaderSync Interfaces ermöglicht das Lesen von File- oder Blob-Objekten auf synchrone Weise in einen String, der eine Daten-URL darstellt. Dieses Interface ist nur verfügbar in Workern, da es synchrones I/O ermöglicht, welches potenziell blockieren könnte.

Syntax

readAsDataURL(blob)

Parameter

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

Rückgabewert

Ein String, der die Eingabedaten als Daten-URL darstellt.

Ausnahmen

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

NotFoundError DOMException

Wird ausgelöst, wenn die durch das DOM File oder Blob repräsentierte 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 gleichzeitig zu viele Lesevorgänge durchgeführt;
die Datei, auf die die Ressource zeigt, ist für die Verwendung im Web unsicher (zum Beispiel ein Systemdatei).

NotReadableError DOMException

Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems, wie einer gleichzeitigen Sperre, 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 # readAsDataURLSync-section