Window: atob()-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.
Die Methode atob() der Schnittstelle Window dekodiert eine Zeichenfolge, die mit Base64 kodiert wurde. Mit der Methode Window.btoa() können Sie Daten kodieren, die andernfalls bei der Übertragung Probleme verursachen könnten. Nach der Übertragung können Sie die Daten mit atob() wieder dekodieren. So lassen sich beispielsweise Steuerzeichen wie die ASCII-Werte 0 bis 31 kodieren, übertragen und dekodieren.
Ziehen Sie auch die Methode Uint8Array.fromBase64() in Betracht. Sie erstellt aus einer Base64-kodierten Zeichenfolge ein Uint8Array-Objekt. Das Ergebnis ist ein Byte-Array, mit dem sich leichter arbeiten lässt als mit einer Zeichenfolge, die rohe Bytes enthält.
Syntax
atob(encodedData)
Parameter
encodedData-
Eine Base64-kodierte Zeichenfolge, die das von
Window.btoa()erzeugte Alphabet verwendet.
Rückgabewert
Eine binäre Zeichenfolge mit den aus encodedData dekodierten rohen Bytes. Zeichenfolgen in JavaScript sind als UTF-16 kodiert. Daher muss jedes Zeichen einen Codepunkt kleiner als 256 haben und steht für ein Datenbyte.
Ausnahmen
InvalidCharacterErrorDOMException-
Wird ausgelöst, wenn
encodedDatakeine gültige Base64-kodierte Zeichenfolge ist.
Beispiele
const encodedData = window.btoa("Hello, world"); // encode a string
const decodedData = window.atob(encodedData); // decode the string
Weitere Beispiele finden Sie bei der Methode Window.btoa().
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-atob-dev |
Browser-Kompatibilität
Siehe auch
- Ein Polyfill für
atobist incore-jsverfügbar. data-URLsWorkerGlobalScope.atob(): dieselbe Methode, jedoch in Worker-Scopes.Window.btoa()Uint8Array.fromBase64()