CKTIS / JavaScript
Longitud e indexación de los arrays tipados
`length` cuenta los elementos de una vista, no sus bytes. Los índices empiezan en cero y escribir más allá del último elemento no amplía la vista.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Un array tipado, como Uint16Array, es una vista sobre un búfer. view.length es una propiedad heredada con un getter y sin setter. Cuenta elementos; view.byteLength cuenta los bytes de la vista y view.buffer.byteLength, los del búfer completo. Asignar un valor a view.length no redimensiona la vista y lanza TypeError en modo estricto.
Los índices de elementos son enteros de 0 a view.length - 1. view[0] y view["0"] se refieren al mismo elemento. Las claves "01" y "1.0" son nombres de propiedades ordinarias, no índices de elementos. view[-0] se comporta como view[0], pero view["-0"] devuelve undefined.
Leer en un índice de elemento no válido devuelve undefined. Escribir en él no modifica el búfer ni añade un elemento, ni siquiera en modo estricto, si la conversión del valor se realiza correctamente. Sin embargo, la conversión puede lanzar un error, por ejemplo al escribir un Number en un BigInt64Array. En un índice válido, el valor se almacena según el tipo de elemento. view[-1] no cuenta desde el final; view.at(-1) sí y devuelve el último elemento de una vista no vacía.
Si el constructor recibe un ArrayBuffer redimensionable o un SharedArrayBuffer que puede crecer, omitir el tercer argumento length (o pasar undefined) crea una vista cuya longitud se ajusta al número de elementos completos desde byteOffset hasta el final actual del búfer. Con un búfer de tamaño fijo, la misma llamada crea una vista de longitud fija. En ese caso, la cantidad de bytes desde byteOffset hasta el final del búfer debe ser un múltiplo del tamaño de un elemento en bytes; de lo contrario, el constructor lanza RangeError. Una longitud explícita fija la cantidad de elementos mientras la vista quepa en el búfer. Si al reducir el búfer la vista queda fuera de sus límites, length devuelve 0; volver a ampliarlo puede hacer que la vista vuelva a caber. Desvincular el búfer también da length === 0. En ambos casos, las lecturas por índice devuelven undefined, pero at() lanza TypeError.
Ejemplos
"use strict";
{
const view = new Uint16Array([10, 20]);
view[1] = 65537;
view[view.length] = 99;
console.log(`${view.length} ${view.byteLength}`);
console.log(`${view[0]} ${view[1]}`);
console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}Resultado
2 4 10 1 undefined undefined 1
Dos elementos de `Uint16Array` ocupan cuatro bytes. Al almacenar `65537` se obtiene `1`, porque solo se conservan los 16 bits menos significativos. Escribir en el índice `2` no amplía la vista; `at(-1)` lee el último elemento.
Lecciones relacionadas
- JavaScript · Lección 33 · Avanzado · Versión: 4
- JavaScript · Lección 34 · Avanzado · Versión: 4