WorkerGlobalScope: btoa()-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.
Die btoa()
-Methode der WorkerGlobalScope
-Schnittstelle erstellt einen Base64-codierten ASCII-String aus einem Binär-String (d.h. ein String, bei dem jedes Zeichen im String als Byte von Binärdaten behandelt wird).
Sie können diese Methode verwenden, um Daten zu codieren, die ansonsten Kommunikationsprobleme verursachen könnten, diese zu übertragen und anschließend die WorkerGlobalScope.atob()
-Methode zu verwenden, um die Daten wieder zu dekodieren. Zum Beispiel können Sie Steuerzeichen wie ASCII-Werte 0 bis 31 codieren.
Syntax
btoa(stringToEncode)
Parameter
stringToEncode
-
Der Binär-String, der codiert werden soll.
Rückgabewert
Ein ASCII-String, der die Base64-Darstellung von stringToEncode
enthält.
Ausnahmen
InvalidCharacterError
DOMException
-
Der String enthielt ein Zeichen, das nicht in ein einzelnes Byte passte. Weitere Informationen finden Sie unten unter „Unicode-Strings“.
Beispiele
const encodedData = self.btoa("Hello, world"); // encode a string
const decodedData = self.atob(encodedData); // decode the string
Unicode-Strings
Base64 ist gemäß seiner Definition dafür konzipiert, Binärdaten als Eingabe zu erwarten. Im Hinblick auf JavaScript-Strings bedeutet dies, dass es sich um Strings handelt, bei denen der Codepunkt jedes Zeichens nur ein Byte belegt. Wenn Sie also einen String an btoa()
übergeben, der Zeichen enthält, die mehr als ein Byte belegen, erhalten Sie einen Fehler, da dies nicht als Binärdaten betrachtet wird.
Weitere Informationen und mögliche Umgehungen finden Sie unter Window.btoa()
.
Spezifikationen
Specification |
---|
HTML # dom-btoa-dev |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
btoa | ||||||||||||||
Available in workers |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
Siehe auch
- Ein Polyfill für
btoa
ist verfügbar incore-js
data
-URLsWorkerGlobalScope.atob()
Window.btoa()
: dieselbe Methode, aber im Scope des Fensters.Uint8Array.prototype.toBase64()
- Base64