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 des WorkerGlobalScope-Interfaces erstellt einen Base64-kodierten ASCII-String aus einem binären String (d.h. einem String, in dem jedes Zeichen als Byte von Binärdaten behandelt wird).

Sie können diese Methode verwenden, um Daten zu kodieren, die ansonsten Kommunikationsprobleme verursachen könnten, sie zu übertragen und dann die WorkerGlobalScope.atob()-Methode zu nutzen, um die Daten wieder zu dekodieren. Zum Beispiel können Sie Steuerzeichen wie ASCII-Werte 0 bis 31 kodieren.

Syntax

js
btoa(stringToEncode)

Parameter

stringToEncode

Der zu kodierende binäre String.

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 Einzelbyte passte. Siehe unten "Unicode-Strings" für mehr Details.

Beispiele

js
const encodedData = self.btoa("Hello, world"); // encode a string
const decodedData = self.atob(encodedData); // decode the string

Unicode-Strings

Base64 erwartet standardmäßig Binärdaten als Eingabe. In Bezug auf JavaScript-Strings bedeutet dies Strings, bei denen der Codepunkt jedes Zeichens nur ein Byte belegt. Wenn Sie also einen String in btoa() übergeben, der Zeichen enthält, die mehr als ein Byte belegen, erhalten Sie einen Fehler, da dies nicht als Binärdaten betrachtet wird.

Für mehr Informationen und Lösungen siehe Window.btoa().

Spezifikationen

Specification
HTML Standard
# dom-btoa-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch