WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

TextDecoderStream — Bytes im Datenstrom dekodieren

TextDecoderStream wandelt einen Bytestrom in Text um und bewahrt den Decoderzustand zwischen den Datenblöcken.

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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream ist eine Web API aus dem Encoding Standard und gehört nicht zu einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit mit typeof TextDecoderStream !== "undefined"; Node 24 belegt keine Unterstützung im Browser.

writable akzeptiert Puffer und Ansichten wie Uint8Array; readable liefert Zeichenfolgen. Verwende pipeThrough(). Unvollständige Sequenzen warten auf weitere Bytes; Ausgabe-Chunks grenzen keine Datensätze ab. Das Schließen der Eingabe schließt die Dekodierung ab.

Standardmäßig wird UTF-8 verwendet; Fehler ergeben U+FFFD. Bei fatal: true schlagen beide Streams mit einem TypeError fehl. Eine ungültige Kodierungsbezeichnung verursacht beim Konstruktor einen RangeError.

ignoreBOM: false entfernt ein anfängliches UTF-8-/UTF-16-BOM; true erhält es im Text. Die Eigenschaften encoding, fatal und ignoreBOM sind schreibgeschützt.

Beispiele

(async () => {
  const bytes = new ReadableStream({
    start(controller) {
      controller.enqueue(new Uint8Array([0x41, 0xE2]));
      controller.enqueue(new Uint8Array([0x82, 0xAC, 0x42]));
      controller.close();
    }
  });

  const reader = bytes
    .pipeThrough(new TextDecoderStream("utf-8", { fatal: true }))
    .getReader();

  let text = "";
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      text += value;
    }
  } finally {
    reader.releaseLock();
  }
  console.log(text);
})().catch(console.error);

Ergebnis

A€B

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