CKTIS / JavaScript
TextDecoder — decodificar bytes en texto
TextDecoder convierte bytes en texto. Aprende a decodificar por fragmentos, gestionar errores con fatal y entender el significado de ignoreBOM.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOMTextDecoder es una API del estándar WHATWG Encoding, no una característica de una edición concreta de ECMAScript. Usa UTF-8 de forma predeterminada; una etiqueta de codificación no válida provoca RangeError.
TextDecoder.decode es un método de instancia: acepta un búfer o una vista de bytes y devuelve texto. { stream: true } conserva las secuencias incompletas entre fragmentos; un decode() final vacía el estado.
TextDecoder.fatal y TextDecoder.ignoreBOM son propiedades de instancia de solo lectura. fatal es false de forma predeterminada: los errores producen U+FFFD; con true se produce TypeError. Para UTF-8 y UTF-16, el valor predeterminado ignoreBOM: false elimina un BOM inicial; true conserva U+FEFF en el resultado.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.