Codificación

TextEncoder codifica cadenas como UTF-8. TextDecoder admite UTF-8, UTF-16, codificaciones heredadas de un byte y codificaciones CJK habituales mediante las etiquetas de WHATWG.

const bytes = new TextEncoder().encode("Hello, мир! 🌍");
new TextDecoder().decode(bytes); // "Hello, мир! 🌍"

TextEncoder

Miembro	Resultado
`encoding`	Siempre `"utf-8"`.
`encode(input = "")`	Un nuevo `Uint8Array`.
`encodeInto(source, destination)`	`{ read, written }` sin puntos de código parciales.

Los sustitutos (surrogates) sin pareja se reemplazan por U+FFFD.

TextDecoder

const decoder = new TextDecoder("latin1");
decoder.decode(new Uint8Array([0x80])); // "€"

Las etiquetas se recortan y se normalizan en mayúsculas/minúsculas. Alias como ascii, iso-8859-1 y latin1 seleccionan Windows-1252. Las etiquetas desconocidas y de reemplazo lanzan RangeError.

Opciones:

fatal: true rechaza la entrada mal formada con TypeError;
ignoreBOM controla el tratamiento del BOM inicial;
decode(input, { stream: true }) conserva una secuencia incompleta para la siguiente llamada.

const decoder = new TextDecoder();
decoder.decode(new Uint8Array([0xc3]), { stream: true }); // ""
decoder.decode(new Uint8Array([0xa9])); // "é"

Streaming

TextEncoderStream convierte fragmentos de cadena en bytes UTF-8. TextDecoderStream convierte fragmentos de bytes en cadenas conservando las secuencias multibyte parciales entre fragmentos.

Los constructores deben llamarse con new.

Reference

Status: Full · 14,178 of 14,266 suite tests pass (99.4%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`TextDecoder`	class	Full	`encoding`, `fatal`, `ignoreBOM`, `decode()`
`TextEncoder`	class	Full	`encoding`, `encode()`, `encodeInto()`

Tests: wpt-wintertc encoding: 14,178 pass, 86 fail, 2 error, 329 skipped. Failing: encoding/encodeInto.any.js (65), encoding/textdecoder-streaming.any.js (16), encoding/streams/decode-bad-chunks.any.js (2), encoding/idlharness.any.js, encoding/single-byte-decoder.window.js, encoding/streams/decode-utf8.any.js, encoding/streams/realms.window.js, encoding/textdecoder-copy.any.js.