WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

TextEncoder – Text als UTF-8 kodieren

TextEncoder wandelt Text in UTF-8-Bytes um. Erfahre, worin sich encode() und encodeInto() unterscheiden und was die Zähler read und written bedeuten.

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

new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)

TextEncoder ist eine API des Encoding Standard und gehört nicht zu ECMAScript selbst. Sie unterstützt ausschließlich UTF-8: Der Konstruktor akzeptiert kein Kodierungslabel, und encoding gibt "utf-8" zurück.

encode(input) erstellt ein neues Uint8Array; wird input weggelassen, bedeutet das leeren Text. encodeInto(source, destination) schreibt in ein vorhandenes Uint8Array. Die Methode gibt read in UTF-16-Codeeinheiten und written in Bytes zurück. Wenn der Platz nicht ausreicht, schreibt sie keine unvollständige UTF-8-Sequenz.

Im Beispiel bietet der Puffer Platz für Aą, aber nicht für das Emoji. Prüfe die Verfügbarkeit der API im Zielbrowser; die Repository-Umgebung belegt nicht, dass der Browser sie unterstützt.

Beispiele

const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));

const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));

Ergebnis

utf-8
65,196,133,240,159,152,128
2 3
65,196,133

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.

Quellen