CKTIS / JavaScript
TypedArray.length — número de elementos de una vista
TypedArray.length indica el número de elementos de un array tipado, no el número de bytes. Lee el valor desde una instancia, por ejemplo, con values.length; no sirve para cambiar el tamaño de la vista.
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.lengthTypedArray.length se refiere aquí a la propiedad de instancia documentada como TypedArray.prototype.length. Léela con typedArray.length, sin paréntesis de llamada. TypedArray es la abstracción común de tipos concretos como Uint16Array, no un constructor global que pueda usarse directamente.
length cuenta los elementos de la vista. byteLength cuenta los bytes de esa vista, mientras que buffer.byteLength describe el búfer completo. Cada elemento de un Uint16Array ocupa 2 bytes, por lo que una vista con una length de 3 tiene una byteLength de 6. Una vista puede cubrir solo una parte de su búfer. En el constructor, byteOffset se indica en bytes y length, en elementos.
La propiedad es un accesor sin setter: asignar un valor a length no cambia el tamaño de un array tipado. Sin embargo, con un búfer redimensionable, la length de una vista que sigue la longitud puede cambiar junto con el búfer. Si al reducir el búfer el rango de la vista deja de ser válido, al leer la propiedad se obtiene 0, también en una vista de longitud fija. Comprueba por separado la compatibilidad con búferes redimensionables; el acceso a length por sí solo no demuestra que exista esa compatibilidad.
Ejemplos
const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);
console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);Resultado
3 6 12
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.