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: Dieses Feature ist nur verfügbar in Web Workers.
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
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
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
- Ein Polyfill von
btoa
ist incore-js
verfügbar data
URLsWorkerGlobalScope.atob()
Window.btoa()
: dieselbe Methode, aber in Window-Bereichen.Uint8Array.prototype.toBase64()
- Base64