Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TypedArray.byteLength — lunghezza della vista in byte

La proprietà byteLength indica quanti byte copre una vista di array tipizzato, non il numero di elementi né la dimensione dell’intero buffer. Si legge da un’istanza e non ha un setter.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

typedArray.byteLength

TypedArray.byteLength indica qui la proprietà dell’istanza, formalmente denominata TypedArray.prototype.byteLength. Si legge come typedArray.byteLength, senza parentesi. TypedArray non è un costruttore globale; usa un tipo concreto, ad esempio Uint16Array. La proprietà non ha un setter: assegnarle un valore non ridimensiona la vista.

length conta gli elementi, mentre byteLength conta i byte: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Al contrario, typedArray.buffer.byteLength descrive l’intero buffer e byteOffset indica in byte l’inizio della vista. Una vista può coprire solo una parte di un buffer; il suo byteLength non misura l’uso totale della memoria dell’oggetto.

Per un buffer ridimensionabile, il byteLength di una vista che segue la lunghezza del buffer può cambiare. Una vista a lunghezza fissa non si espande insieme al buffer. Se la riduzione del buffer rende non valido l’intervallo della vista, byteLength diventa 0.

La proprietà di base è ampiamente disponibile nei browser da luglio 2015; il supporto per i buffer ridimensionabili va verificato separatamente. Nell’esempio, il terzo argomento di Uint16Array indica 3 elementi, non 3 byte: la vista copre 6 byte all’interno di un buffer di 16 byte.

Esempi

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);

Risultato

3
2
6
4
16

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti