FileReaderSync: readAsDataURL() 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 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
Rückgabewert
Ein String, der die Eingabedaten als Data-URL darstellt.
Ausnahmen
Die folgende Ausnahmen können von dieser Methode ausgelöst werden:
NotFoundErrorDOMException-
Ausgelöst, wenn die Ressource, die durch das DOM
FileoderBlobrepräsentiert wird, nicht gefunden werden kann, z.B., weil sie gelöscht wurde. SecurityErrorDOMException-
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).
NotReadableErrorDOMException-
Ausgelöst, wenn die Ressource aufgrund eines Berechtigungsproblems nicht gelesen werden kann, wie z.B. ein gleichzeitiger Sperrzugriff.
EncodingErrorDOMException-
Ausgelöst, wenn die Ressource eine Data-URL ist und die von jedem Browser definierte Längenbeschränkung überschreitet.
Spezifikationen
| Spezifikation |
|---|
| File API # readAsDataURLSync-section |