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

CKTIS / JavaScript

TextEncoder — codificar texto como UTF-8

TextEncoder convierte texto en bytes UTF-8. Descubre en qué se diferencian encode() y encodeInto() y qué significan los contadores read y written.

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 TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)

TextEncoder es una API del Encoding Standard, no forma parte de ECMAScript en sí. Solo admite UTF-8: su constructor no acepta ninguna etiqueta de codificación y encoding devuelve "utf-8".

encode(input) crea un nuevo Uint8Array; si se omite input, se considera que el texto está vacío. encodeInto(source, destination) escribe en un Uint8Array existente. Devuelve read en unidades de código UTF-16 y written en bytes. Si no queda espacio suficiente, no escribe una secuencia UTF-8 parcial.

En el ejemplo, el búfer tiene espacio para Aą, pero no para el emoji. Comprueba la disponibilidad de la API en el navegador de destino; el entorno del repositorio no demuestra que el navegador sea compatible.

Ejemplos

const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));

const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));

Resultado

utf-8
65,196,133,240,159,152,128
2 3
65,196,133

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