Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TextDecoderStream — priebežné dekódovanie bajtov

TextDecoderStream prevádza prúd bajtov na text a zachováva stav dekodéra medzi jednotlivými blokmi.

Verzia: 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 je Web API zo štandardu Encoding, nie súčasť konkrétnej edície ECMAScriptu. Dostupnosť overte pomocou typeof TextDecoderStream !== "undefined"; Node 24 nepotvrdzuje podporu v prehliadačoch.

writable prijíma buffery a pohľady, napríklad Uint8Array; readable poskytuje reťazce. Používajte pipeThrough(). Neúplné sekvencie čakajú na ďalšie bajty; výstupné bloky nevymedzujú záznamy. Uzavretie vstupu dokončí dekódovanie.

Predvolené kódovanie je UTF-8; chyby vedú k U+FFFD. Pri fatal: true sa oba streamy skončia chybou TypeError. Neplatný štítok kódovania spôsobí pri vytvorení konštruktora chybu RangeError.

ignoreBOM: false odstráni počiatočný BOM UTF-8/UTF-16; true ho zachová v texte. Vlastnosti encoding, fatal a ignoreBOM sú iba na čítanie.

Prí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ýsledok

A€B

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje