CKTIS / JavaScript
Comprimento e indexação dos arrays tipados
`length` conta os elementos de uma vista, não os seus bytes. Os índices começam em zero e escrever para além do último elemento não aumenta a vista.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Um array tipado, como Uint16Array, é uma vista sobre um buffer. view.length é uma propriedade herdada com um getter e sem setter. Conta os elementos; view.byteLength conta os bytes da vista e view.buffer.byteLength os do buffer inteiro. Atribuir um valor a view.length não redimensiona a vista e lança um TypeError em modo estrito.
Os índices dos elementos são inteiros de 0 a view.length - 1. view[0] e view["0"] referem-se ao mesmo elemento. As chaves "01" e "1.0" são nomes de propriedades comuns, não índices de elementos. view[-0] comporta-se como view[0], mas view["-0"] devolve undefined.
Ler num índice de elemento inválido devolve undefined. Escrever nesse índice não altera o buffer nem acrescenta um elemento, mesmo em modo estrito, se a conversão do valor for bem-sucedida. No entanto, a conversão pode lançar um erro, por exemplo ao escrever um Number num BigInt64Array. Num índice válido, o valor é guardado de acordo com o tipo do elemento. view[-1] não conta a partir do fim; view.at(-1) conta e devolve o último elemento de uma vista não vazia.
Se o construtor receber um ArrayBuffer redimensionável ou um SharedArrayBuffer que possa crescer, omitir o terceiro argumento length (ou passar undefined) cria uma vista cujo comprimento se ajusta ao número de elementos completos desde byteOffset até ao fim atual do buffer. Com um buffer de tamanho fixo, a mesma chamada cria uma vista de comprimento fixo. Nesse caso, o número de bytes desde byteOffset até ao fim do buffer tem de ser um múltiplo do tamanho de um elemento em bytes; caso contrário, o construtor lança um RangeError. Um comprimento explícito fixa o número de elementos enquanto a vista couber no buffer. Se o buffer encolher e a vista ficar fora dos seus limites, length devolve 0; voltar a aumentar o buffer pode fazer com que a vista volte a caber. O desanexamento do buffer também resulta em length === 0. Em ambos os casos, as leituras por índice devolvem undefined, mas at() lança um TypeError.
Exemplos
"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
Dois elementos de `Uint16Array` ocupam quatro bytes. Guardar `65537` dá `1`, porque só se conservam os 16 bits menos significativos. Escrever no índice `2` não aumenta a vista; `at(-1)` lê o último elemento.
Lições relacionadas
- JavaScript · Lição 33 · Avançado · Versão: 4
- JavaScript · Lição 34 · Avançado · Versão: 4