CKTIS / JavaScript
TextEncoder.encode() — Text in UTF-8-Bytes umwandeln
TextEncoder.encode() kodiert eine JavaScript-Zeichenfolge als UTF-8 und gibt ein Uint8Array mit den resultierenden Bytes zurück. Rufe die Methode auf einer TextEncoder-Instanz auf; die Anzahl der Bytes muss nicht der Zeichenfolgenlänge entsprechen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode ist eine Instanzmethode: Erstelle mit new TextEncoder() ein Objekt und rufe anschließend encoder.encode(text) auf. Das Ergebnis ist ein Uint8Array mit den UTF-8-Bytes des Textes, keine neue Zeichenfolge. TextEncoder unterstützt ausschließlich UTF-8 und dient nicht zur Auswahl anderer Kodierungen.
Setze text.length nicht mit der Größe der kodierten Daten gleich. Die Länge einer JavaScript-Zeichenfolge wird in UTF-16-Codeeinheiten gemessen, während bytes.length die Anzahl der resultierenden Bytes angibt. Im Beispiel belegt A ein Byte und € drei: Die Zeichenfolge "A€" hat die Länge 2, das Ergebnis umfasst jedoch 4 Bytes.
encode() erstellt ein Ergebnisarray. Wenn du in ein vorhandenes Uint8Array schreiben möchtest, kommt die separate Methode encodeInto() infrage: Sie nimmt ein Zielarray entgegen und gibt Informationen zum Fortschritt statt eines Bytearrays zurück. Prüfe ihre Unterstützung unabhängig von encode().
Dies ist eine Web-API, die im Encoding-Standard definiert ist, keine Funktion, die einer ECMAScript-Version zugeordnet ist. Laut MDN ist encode() seit Januar 2020 in Browsern weit verbreitet und auch in Web Workers verfügbar. Dass die API in Node 24 vorhanden ist, belegt nicht, dass sie im Zielbrowser unterstützt wird.
Beispiele
const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);Ergebnis
true 65,226,130,172 2 4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.