CKTIS / JavaScript
TypedArray.length — número de elementos de uma vista
TypedArray.length indica o número de elementos de um array tipado, não o número de bytes. Leia o valor numa instância, por exemplo, com values.length; não serve para redimensionar a vista.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
typedArray.lengthTypedArray.length designa aqui a propriedade da instância documentada como TypedArray.prototype.length. Leia-a com typedArray.length, sem parênteses de chamada. TypedArray é a abstração comum a tipos concretos como Uint16Array, não um construtor global que possa ser utilizado diretamente.
length conta os elementos da vista. byteLength conta os bytes dessa vista, enquanto buffer.byteLength descreve o buffer inteiro. Cada elemento de um Uint16Array ocupa 2 bytes, pelo que uma vista com uma length de 3 tem uma byteLength de 6. Uma vista pode abranger apenas parte do buffer. No construtor, byteOffset é especificado em bytes e length em elementos.
A propriedade é um accessor sem setter: atribuir um valor a length não redimensiona um array tipado. No entanto, com um buffer redimensionável, a length de uma vista que acompanha o comprimento pode mudar à medida que o buffer muda. Se o encurtamento do buffer tornar inválido o intervalo da vista, a leitura da propriedade devolve 0, mesmo numa vista de comprimento fixo. Verifique separadamente o suporte de buffers redimensionáveis; o simples acesso a length não comprova esse suporte.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.