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.