CKTIS / JavaScript
TextEncoder.encode() — convertir texto en bytes UTF-8
TextEncoder.encode() codifica una cadena de JavaScript como UTF-8 y devuelve un Uint8Array con los bytes resultantes. Llama al método en una instancia de TextEncoder; el número de bytes no tiene por qué coincidir con la longitud de la cadena.
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
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode es un método de instancia: crea un objeto con new TextEncoder() y, después, llama a encoder.encode(text). El resultado es un Uint8Array con los bytes UTF-8 del texto, no una cadena nueva. TextEncoder solo admite UTF-8; no sirve para elegir otras codificaciones.
No confundas text.length con el tamaño de los datos codificados. La longitud de una cadena de JavaScript se mide en unidades de código UTF-16, mientras que bytes.length cuenta los bytes resultantes. En el ejemplo, A ocupa un byte y € ocupa tres: la cadena "A€" tiene una longitud de 2, pero el resultado codificado contiene 4 bytes.
encode() crea el array de resultado. Si quieres escribir en un Uint8Array existente, puedes considerar el método independiente encodeInto(): acepta un array de destino y devuelve información sobre el progreso en lugar de un array de bytes. Comprueba su compatibilidad de forma independiente a la de encode().
Esta es una API web definida por el estándar Encoding, no una función asignada a una edición de ECMAScript. Según MDN, encode() está ampliamente disponible en los navegadores desde enero de 2020 y también funciona en Web Workers. Que esté presente en Node 24 no demuestra que sea compatible con el navegador de destino.
Ejemplos
const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);Resultado
true 65,226,130,172 2 4
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.