CKTIS / JavaScript
TextEncoderStream — codificación UTF-8 en flujo
TextEncoderStream transforma fragmentos de texto en bytes UTF-8 y conserva los pares sustitutos divididos entre varios fragmentos.
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 TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())TextEncoderStream es una API web del estándar WHATWG Encoding, no una característica de ECMAScript. Su constructor no acepta opciones de codificación; encoding siempre devuelve "utf-8".
writable acepta texto y readable proporciona fragmentos Uint8Array. Conecta una fuente mediante pipeThrough(). A diferencia de las llamadas independientes a TextEncoder.encode(), el flujo conserva un par sustituto dividido entre varios fragmentos. Los sustitutos sin pareja se reemplazan por U+FFFD; un sustituto inicial al final espera hasta que se cierre la entrada.
El ejemplo reúne los bytes sin suponer que coincidan los límites de los fragmentos. Comprueba la disponibilidad de la API en el navegador de destino; que el repositorio incluya Node 24 no demuestra que los navegadores la admitan.
Ejemplos
(async () => {
if (typeof TextEncoderStream === "undefined") {
throw new Error("TextEncoderStream unavailable");
}
const source = new ReadableStream({
start(controller) {
controller.enqueue("A\uD83D");
controller.enqueue("\uDE00");
controller.close();
}
});
const encoder = new TextEncoderStream();
const reader = source.pipeThrough(encoder).getReader();
const bytes = [];
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
bytes.push(...value);
}
} finally {
reader.releaseLock();
}
console.log(encoder.encoding);
console.log(bytes.join(","));
})().catch(console.error);Resultado
utf-8 65,240,159,152,128
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.