CKTIS / JavaScript
TypedArray.byteLength — longitud de la vista en bytes
La propiedad byteLength indica cuántos bytes abarca una vista de array tipado, no cuántos elementos contiene ni el tamaño de todo su búfer. Se lee desde una instancia y no tiene setter.
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
typedArray.byteLengthTypedArray.byteLength se refiere aquí a la propiedad de instancia, cuyo nombre formal es TypedArray.prototype.byteLength. Se lee como typedArray.byteLength, sin paréntesis. TypedArray no es un constructor global; usa un tipo concreto, como Uint16Array. La propiedad no tiene setter: asignarle un valor no cambia el tamaño de la vista.
length cuenta elementos, mientras que byteLength cuenta bytes: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. En cambio, typedArray.buffer.byteLength describe el búfer completo, y byteOffset indica en bytes dónde empieza la vista. Una vista puede abarcar solo una parte de un búfer; su byteLength no mide el uso total de memoria del objeto.
En un búfer redimensionable, el byteLength de una vista que sigue la longitud del búfer puede cambiar. Una vista de longitud fija no se amplía junto con el búfer. Si al reducir el búfer el rango de la vista deja de ser válido, byteLength pasa a ser 0.
La propiedad básica está ampliamente disponible en los navegadores desde julio de 2015; la compatibilidad con búferes redimensionables debe comprobarse por separado. En el ejemplo, el tercer argumento de Uint16Array significa 3 elementos, no 3 bytes: la vista abarca 6 bytes dentro de un búfer de 16 bytes.
Ejemplos
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);Resultado
3 2 6 4 16
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.