CKTIS / JavaScript
TextEncoder.encode y TypedArray.byteLength: contar bytes UTF-8
Codifica texto en UTF-8 y mide los bytes obtenidos. Distingue ese tamaño del número de unidades de código UTF-16, del número de elementos de un array tipado y del tamaño total del búfer.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
const byteCount = bytes.byteLength;
// With no argument, encoder.encode() returns an empty Uint8Array.
// For any typed-array instance: view.byteLengthnew TextEncoder().encode(text) llama a un método de instancia que codifica una cadena únicamente en UTF-8 y devuelve un nuevo Uint8Array. Sin argumentos, devuelve un Uint8Array vacío. Cada unidad sustituta de UTF-16 que no forma pareja se reemplaza por U+FFFD en lugar de provocar un error.
view.byteLength es una propiedad de solo lectura, no un método. Cuenta los bytes de la vista; view.length cuenta sus elementos y view.buffer.byteLength cuenta los bytes de todo el búfer subyacente. Si la vista está dentro de los límites del búfer, view.byteLength es igual a view.length * view.BYTES_PER_ELEMENT. En un Uint8Array, cada elemento ocupa un byte. text.length cuenta unidades de código UTF-16, no bytes UTF-8. Usa bytes.byteLength para comprobar un límite expresado en bytes UTF-8.
ECMAScript 2024 define la propiedad de los arrays tipados. TextEncoder es una API de la plataforma web y su disponibilidad depende del entorno de ejecución. Si el búfer es redimensionable, una vista que sigue el tamaño del búfer puede cambiar de tamaño. Leer byteLength devuelve 0 si el búfer está desvinculado o la vista queda fuera de sus límites. Invocar el getter sobre un objeto que no es un array tipado lanza TypeError.
Ejemplos
{
const text = "Aé🙂";
const bytes = new TextEncoder().encode(text);
console.log(`text.length=${text.length}; bytes.length=${bytes.length}; bytes.byteLength=${bytes.byteLength}`);
console.log(bytes.join(","));
const view = new Uint16Array(new ArrayBuffer(12), 2, 3);
console.log(`view.length=${view.length}; view.byteLength=${view.byteLength}; view.buffer.byteLength=${view.buffer.byteLength}`);
}Resultado
text.length=4; bytes.length=7; bytes.byteLength=7 65,195,169,240,159,153,130 view.length=3; view.byteLength=6; view.buffer.byteLength=12
`Aé🙂` ocupa 4 unidades de código UTF-16 y 7 bytes UTF-8. La vista `Uint16Array` tiene 3 elementos de 2 bytes cada uno, así que abarca 6 de los 12 bytes del búfer.
Lecciones relacionadas
- JavaScript · Lección 17 · Avanzado · Versión: 4