CKTIS / JavaScript
TypedArray.length — numero di elementi di una vista
TypedArray.length indica il numero di elementi di un array tipizzato, non il numero di byte. Leggilo da un’istanza, per esempio con values.length; non serve a ridimensionare la vista.
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.lengthTypedArray.length indica qui la proprietà dell’istanza documentata come TypedArray.prototype.length. Leggila con typedArray.length, senza parentesi di chiamata. TypedArray è l’astrazione comune a tipi concreti come Uint16Array, non un costruttore globale utilizzabile direttamente.
length conta gli elementi della vista. byteLength conta i byte della vista, mentre buffer.byteLength descrive l’intero buffer. Ogni elemento di un Uint16Array occupa 2 byte, quindi una vista con una length pari a 3 ha una byteLength pari a 6. Una vista può coprire solo una parte del buffer. Nel costruttore, byteOffset si specifica in byte e length in elementi.
La proprietà è un accessor senza setter: assegnare un valore a length non ridimensiona un array tipizzato. Con un buffer ridimensionabile, però, la length di una vista che segue la lunghezza può cambiare insieme al buffer. Se il restringimento del buffer rende non valido l’intervallo della vista, la lettura della proprietà restituisce 0, anche per una vista a lunghezza fissa. Verifica separatamente il supporto dei buffer ridimensionabili: il solo accesso a length non dimostra che tale supporto sia disponibile.
Esempi
const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);
console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);Risultato
3 6 12
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.