CKTIS / JavaScript
TextDecoder — decodificare byte in testo
TextDecoder converte i byte in testo. Scopri la decodifica a blocchi, la gestione degli errori con fatal e il significato di ignoreBOM.
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 TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOMTextDecoder è un’API dello standard WHATWG Encoding, non una funzionalità di una specifica edizione di ECMAScript. Per impostazione predefinita usa UTF-8; un’etichetta di codifica non valida causa RangeError.
TextDecoder.decode è un metodo di istanza: accetta un buffer o una vista di byte e restituisce testo. { stream: true } conserva le sequenze incomplete tra i blocchi; un decode() finale svuota lo stato.
TextDecoder.fatal e TextDecoder.ignoreBOM indicano proprietà di istanza di sola lettura. fatal è false per impostazione predefinita: gli errori producono U+FFFD; con true causano TypeError. Per UTF-8 e UTF-16, il valore predefinito ignoreBOM: false rimuove un BOM iniziale; true conserva U+FEFF nel risultato.
Esempi
const decoder = new TextDecoder("utf-8", { fatal: true });
const first = decoder.decode(new Uint8Array([0xE2, 0x82]), { stream: true });
const last = decoder.decode(new Uint8Array([0xAC]));
console.log(JSON.stringify([first, last, decoder.decode()]));
console.log(decoder.fatal, decoder.ignoreBOM);Risultato
["","€",""] true false
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.