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

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.

Fuentes