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 der FileReaderSync Schnittstelle ermöglicht das synchrone Lesen von File oder Blob Objekten in einen String, der eine Daten-URL darstellt. Diese Schnittstelle ist nur verfügbar in Arbeitern, da sie synchrones I/O ermöglicht, das potenziell blockieren könnte.

Syntax

js
readAsDataURL(blob)

Parameter

blob

Die File oder der 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 Ressource, die durch die DOM File oder den 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 modifiziert;
  • es werden gleichzeitig zu viele Lesevorgänge durchgeführt;
  • die Datei, auf die die Ressource verweist, ist unsicher für eine Verwendung aus dem Web (wie etwa eine Systemdatei).
NotReadableError DOMException

Wird ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie etwa ein gleichzeitiger Sperrmechanismus.

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch