CKTIS / JavaScript
TextEncoderStream — UTF-8-Codierung im Datenstrom
TextEncoderStream wandelt Textabschnitte in UTF-8-Bytes um und bewahrt dabei Surrogatpaare, die über mehrere Abschnitte verteilt sind.
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 TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())TextEncoderStream ist eine Web-API des WHATWG-Encoding-Standards und kein Bestandteil von ECMAScript. Der Konstruktor nimmt keine Optionen für die Codierung entgegen; encoding gibt immer "utf-8" zurück.
writable nimmt Text entgegen, während readable Uint8Array-Abschnitte bereitstellt. Verbinde eine Quelle mit pipeThrough(). Anders als bei einzelnen Aufrufen von TextEncoder.encode() bewahrt der Stream ein Surrogatpaar, das über mehrere Abschnitte verteilt ist. Nicht gepaarte Surrogate werden durch U+FFFD ersetzt; ein abschließendes führendes Surrogat wartet, bis die Eingabe geschlossen wird.
Das Beispiel sammelt die Bytes, ohne übereinstimmende Abschnittsgrenzen vorauszusetzen. Prüfe die Verfügbarkeit der API im Zielbrowser; Node 24 im Repository belegt keine Browserunterstützung.
Beispiele
(async () => {
if (typeof TextEncoderStream === "undefined") {
throw new Error("TextEncoderStream unavailable");
}
const source = new ReadableStream({
start(controller) {
controller.enqueue("A\uD83D");
controller.enqueue("\uDE00");
controller.close();
}
});
const encoder = new TextEncoderStream();
const reader = source.pipeThrough(encoder).getReader();
const bytes = [];
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
bytes.push(...value);
}
} finally {
reader.releaseLock();
}
console.log(encoder.encoding);
console.log(bytes.join(","));
})().catch(console.error);Ergebnis
utf-8 65,240,159,152,128
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.