Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TextDecoderStream — decodifica byte in streaming

TextDecoderStream converte un flusso di byte in testo, mantenendo lo stato del decodificatore tra i blocchi.

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

Sintassi

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

TextDecoderStream è una Web API dello standard Encoding, non di una specifica edizione di ECMAScript. Verifica che sia disponibile con typeof TextDecoderStream !== "undefined"; Node 24 non dimostra il supporto nei browser.

writable accetta buffer e viste come Uint8Array; readable fornisce stringhe. Usa pipeThrough(). Le sequenze incomplete attendono altri byte; i blocchi di output non delimitano i record. La chiusura dell’input completa la decodifica.

UTF-8 è la codifica predefinita; gli errori producono U+FFFD. Con fatal: true, entrambi gli stream terminano con un TypeError. Un’etichetta di codifica non valida causa un RangeError nel costruttore.

ignoreBOM: false rimuove un BOM iniziale UTF-8/UTF-16; true lo conserva nel testo. Le proprietà encoding, fatal e ignoreBOM sono di sola lettura.

Esempi

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

Risultato

A€B

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti