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.