Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

TextDecoder — descodificar bytes em texto

TextDecoder converte bytes em texto. Aprende a descodificar por blocos, a gerir erros com fatal e a compreender o significado de ignoreBOM.

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

Sintaxe

new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOM

TextDecoder é uma API do padrão WHATWG Encoding, não uma funcionalidade de uma edição específica do ECMAScript. Usa UTF-8 por predefinição; uma etiqueta de codificação inválida provoca RangeError.

TextDecoder.decode é um método de instância: aceita um buffer ou uma vista de bytes e devolve texto. { stream: true } mantém sequências incompletas entre blocos; um decode() final limpa o estado.

TextDecoder.fatal e TextDecoder.ignoreBOM designam propriedades de instância só de leitura. fatal é false por predefinição: os erros produzem U+FFFD; com true, provocam TypeError. Para UTF-8 e UTF-16, o valor predefinido ignoreBOM: false remove um BOM inicial; true preserva U+FEFF no resultado.

Exemplos

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

Resultado

["","€",""]
true false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes