Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TextDecoderStream — průběžné dekódování bajtů

TextDecoderStream převádí proud bajtů na text a zachovává stav dekodéru mezi jednotlivými bloky.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream je Web API ze standardu Encoding, nikoli součást konkrétní edice ECMAScriptu. Dostupnost ověřte pomocí typeof TextDecoderStream !== "undefined"; Node 24 nepotvrzuje podporu v prohlížečích.

writable přijímá buffery a pohledy, například Uint8Array; readable poskytuje řetězce. Používejte pipeThrough(). Neúplné sekvence čekají na další bajty; výstupní bloky nevymezují záznamy. Uzavření vstupu dokončí dekódování.

Výchozí kódování je UTF-8; chyby vedou k U+FFFD. Při fatal: true skončí oba streamy chybou TypeError. Neplatný štítek kódování způsobí při vytvoření konstruktoru chybu RangeError.

ignoreBOM: false odstraní počáteční BOM UTF-8/UTF-16; true jej zachová v textu. Vlastnosti encoding, fatal a ignoreBOM jsou pouze pro čtení.

Příklady

(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);

Výsledek

A€B

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje