Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

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

Fuentes