Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Uint16Array — array tipizzato senza segno a 16 bit

Uint16Array è una vista tipizzata su un buffer che memorizza interi da 0 a 65535, usando 2 byte per elemento. Scopri come vengono convertiti i valori e la differenza tra copiare i dati e condividere una 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

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array è un array tipizzato integrato in ECMAScript, non un normale Array. Ogni elemento occupa 2 byte e, quando viene letto, restituisce un Number compreso tra 0 e 65535. length indica il numero di elementi, byteLength il numero di byte della vista e Uint16Array.BYTES_PER_ELEMENT vale 2.

Il costruttore richiede new. Se l’argomento è numerico, il costruttore usa ToIndex per determinare il numero di elementi inizializzati a zero. Ad esempio, new Uint16Array(3.9) crea tre elementi, mentre new Uint16Array(-1) genera un RangeError. Una raccolta fornisce i valori da copiare. La variante con ArrayBuffer crea una vista senza copiare: byteOffset è espresso in byte e deve essere un multiplo di 2, mentre length, facoltativo, conta gli elementi, non i byte.

In scrittura, i valori vengono convertiti anziché controllati rispetto al loro intervallo: i valori Number finiti vengono troncati verso zero e poi ridotti modulo 65536. Quindi 65536 diventa 0, -1 diventa 65535 e 3.9 diventa 3. NaN e gli infiniti diventano 0; i valori BigInt causano un TypeError. Non si tratta di un troncamento ai limiti dell’intervallo.

subarray() condivide la memoria con l’originale, mentre slice() copia i dati. L’esempio mostra la conversione e la modifica dell’originale tramite una vista. L’ordine dei byte è quello nativo dell’implementazione; usa DataView per un formato binario con ordine dei byte esplicito.

Esempi

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Risultato

65535,42,65535,3
4 8 2

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