Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Uint8Array — una vista di byte senza segno

Uint8Array espone i dati di un buffer come interi senza segno a 8 bit, compresi tra 0 e 255. Consente di creare e copiare byte o condividere memoria tramite viste; le scritture fuori intervallo tornano nell’intervallo invece di essere limitate.

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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])

Uint8Array è un array tipizzato: una vista di un buffer i cui elementi occupano un byte ciascuno e vengono letti come valori Number da 0 a 255. Non è un normale Array. La proprietà length indica il numero di elementi, byteLength la dimensione della vista in byte e buffer espone il buffer sottostante.

new Uint8Array(length) crea un buffer riempito di zeri. new Uint8Array(values) copia valori da un oggetto iterabile o simile a un array. new Uint8Array(buffer, byteOffset, length) crea una vista di un buffer esistente senza copiarlo; byteOffset è uno spostamento in byte e length indica il numero di elementi. Il costruttore richiede new.

In caso di assegnazione, i numeri finiti vengono troncati verso zero e poi ridotti modulo 256: 256 diventa 0 e -1 diventa 255. NaN e gli infiniti diventano 0. Questo non è né una convalida dell’intervallo né un limite come quello di Uint8ClampedArray; verifica i dati non validi prima di scriverli.

subarray() crea una vista che condivide la memoria, mentre slice() crea una copia indipendente. Nell’esempio, modificare view[0] modifica anche bytes[1], ma lascia copy invariato. Questa voce tratta le operazioni fondamentali di ECMAScript, non i metodi di codifica più recenti. La specifica da sola non dimostra la compatibilità con un browser specifico; nemmeno la presenza di Node 24 in un repository la dimostra.

Esempi

const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);

Risultato

0,42,0,255
255,0
4: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.

Fonti