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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
btoa
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch