Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.byteLength

TypedArray.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.

Fontes