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 September 2016.

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

js
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

js
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

BCD tables only load in the browser

Siehe auch