Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.ignoreBOM

TextDecoder è 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.

Fonti