FileReaderSync: readAsDataURL() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist nur in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die readAsDataURL() Methode der FileReaderSync Schnittstelle ermöglicht das Lesen von File oder Blob Objekten auf synchronem Weg in einen String, der eine Data-URL darstellt. Diese Schnittstelle ist nur verfügbar in Workern, da sie eine synchrone I/O ermöglicht, die potenziell blockieren könnte.

Syntax

readAsDataURL(blob)

Parameter

blob: Das File oder Blob, das gelesen werden soll.

Rückgabewert

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

Ausnahmen

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

NotFoundError DOMException

Ausgelöst, wenn die Ressource, die durch das DOM File oder Blob repräsentiert wird, nicht gefunden werden kann, z.B., weil sie gelöscht wurde.

SecurityError DOMException

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 die Nutzung im Web (z.B. ein Systemdatei).

NotReadableError DOMException

Ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie z.B. ein gleichzeitiger Sperrzugriff.

EncodingError DOMException

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

Spezifikationen

Specification
File API # readAsDataURLSync-section