CKTIS / JavaScript
TypedArray.byteLength — comprimento da vista em bytes
A propriedade byteLength indica o número de bytes abrangidos por uma vista de array tipado, não o número de elementos nem o tamanho do buffer inteiro. É lida numa instância e não tem setter.
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.byteLengthTypedArray.byteLength designa aqui a propriedade da instância, formalmente denominada TypedArray.prototype.byteLength. Leia-a como typedArray.byteLength, sem parênteses. TypedArray não é um construtor global; utilize um tipo concreto, como Uint16Array. A propriedade não tem setter: atribuir-lhe um valor não redimensiona a vista.
length conta elementos, enquanto byteLength conta bytes: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Em contrapartida, typedArray.buffer.byteLength descreve o buffer inteiro, e byteOffset indica o início da vista em bytes. Uma vista pode abranger apenas parte de um buffer; o seu byteLength não mede a utilização total de memória do objeto.
Num buffer redimensionável, o byteLength de uma vista que acompanha o comprimento do buffer pode mudar. Uma vista de comprimento fixo não se expande com o buffer. Se a redução do buffer tornar inválido o intervalo da vista, byteLength passa a 0.
A propriedade básica está amplamente disponível nos browsers desde julho de 2015; o suporte para buffers redimensionáveis deve ser verificado separadamente. No exemplo, o terceiro argumento de Uint16Array significa 3 elementos, não 3 bytes: a vista abrange 6 bytes num buffer de 16 bytes.
Exemplos
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
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.