CKTIS / JavaScript
TextDecoderStream — decodificación de bytes en flujo
TextDecoderStream convierte un flujo de bytes en texto y conserva el estado del decodificador entre bloques.
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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})TextDecoderStream es una API web del Encoding Standard, no de una edición concreta de ECMAScript. Comprueba si está disponible con typeof TextDecoderStream !== "undefined"; Node 24 no demuestra que sea compatible con los navegadores.
writable acepta búferes y vistas como Uint8Array; readable proporciona cadenas. Usa pipeThrough(). Las secuencias incompletas esperan a que lleguen más bytes; los bloques de salida no delimitan registros. Cerrar la entrada finaliza la decodificación.
UTF-8 es la codificación predeterminada; los errores producen U+FFFD. Con fatal: true, ambos flujos fallan con un TypeError. Una etiqueta de codificación no válida provoca un RangeError en el constructor.
ignoreBOM: false elimina un BOM inicial UTF-8/UTF-16; true lo conserva en el texto. Las propiedades encoding, fatal e ignoreBOM son de solo lectura.
Ejemplos
(async () => {
const bytes = new ReadableStream({
start(controller) {
controller.enqueue(new Uint8Array([0x41, 0xE2]));
controller.enqueue(new Uint8Array([0x82, 0xAC, 0x42]));
controller.close();
}
});
const reader = bytes
.pipeThrough(new TextDecoderStream("utf-8", { fatal: true }))
.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
})().catch(console.error);Resultado
A€B
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.