WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen