CKTIS / JavaScript
TypedArray: dimensioni, indicizzazione, viste e copie
Scopri la differenza tra numero di elementi e numero di byte in TypedArray. Vedi come buffer e byteOffset descrivono una vista e perché subarray() condivide i dati mentre slice() crea una copia indipendente.
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
const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);TypedArray è l’interfaccia comune delle viste tipizzate sui dati binari, non un costruttore disponibile globalmente. Usa un tipo concreto come Uint16Array. Queste API appartengono a ECMAScript e non richiedono il DOM. Qui, TypedArray.length, TypedArray.byteLength, TypedArray.buffer e TypedArray.byteOffset indicano proprietà di istanza come view.length, non proprietà statiche.
length conta gli elementi, byteLength conta i byte della vista, buffer fa riferimento all’intero ArrayBuffer o SharedArrayBuffer sottostante e byteOffset indica l’inizio della vista in byte rispetto al buffer. Per una vista valida, byteLength === length * BYTES_PER_ELEMENT. Una vista può coprire solo una parte del buffer. In new Uint16Array(buffer, byteOffset, length), l’offset deve essere un multiplo di 2, mentre length continua a contare gli elementi. Queste proprietà sono di sola lettura; tuttavia, il ridimensionamento del buffer può modificare le dimensioni riportate e una vista fuori dai limiti riporta dimensioni e offset pari a zero.
TypedArray.indexing indica la sintassi view[index], non un metodo. Gli indici partono da zero e individuano gli elementi a partire dall’inizio della vista. L’assegnazione converte il valore nel tipo dell’elemento. Una lettura fuori dai limiti restituisce undefined; una scrittura fuori dai limiti non estende la vista e non memorizza alcun valore. view[-1] non legge l’ultimo elemento.
TypedArray.prototype.subarray(begin, end) crea una nuova vista che condivide il buffer: le modifiche agli elementi sovrapposti sono visibili in entrambe le viste. TypedArray.prototype.slice(start, end) copia gli elementi selezionati in un buffer indipendente. Entrambi i metodi esprimono i limiti in elementi, includono l’inizio ed escludono la fine; i limiti negativi si contano dalla fine e, se la fine è omessa, si intende la fine della vista. Queste regole descrivono i normali tipi integrati; le sottoclassi personalizzate possono modificare la creazione dei risultati tramite Symbol.species.
Esempi
const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);Risultato
4 8 2 12 4 true false 10,99,30,40 99,30 20,30 undefined 4
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.