CKTIS / JavaScript
Uint8ClampedArray — byte con valori limitati
Uint8ClampedArray è un array tipizzato che memorizza numeri interi da 0 a 255. Quando scrive, limita i valori a questo intervallo e arrotonda le frazioni, invece di farli tornare ciclicamente come fa Uint8Array.
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 Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray è un tipo standard di ECMAScript: una vista su un buffer i cui elementi occupano un byte ciascuno e rappresentano numeri interi senza segno da 0 a 255. I valori letti sono di tipo Number; non è un normale Array.
Le scritture applicano ToUint8Clamp: i valori inferiori a 0 diventano 0, mentre quelli superiori a 255 diventano 255. Le frazioni vengono arrotondate all’intero più vicino; in caso di parità esatta si arrotonda all’intero pari. Quindi 2.5 diventa 2 e 3.5 diventa 4. È una regola diversa da Math.round. NaN diventa 0, Infinity diventa 255 e -Infinity diventa 0. Uint8Array, invece, tronca le frazioni e fa tornare ciclicamente gli interi modulo 256.
new Uint8ClampedArray(length) crea elementi inizializzati a zero, mentre new Uint8ClampedArray(values) copia e converte i valori. La forma con buffer crea una vista sulla memoria esistente senza copiare; la sola creazione della vista non converte i byte memorizzati. Il costruttore richiede new.
L’esempio mostra la limitazione e l’arrotondamento durante la costruzione e una successiva assegnazione. La limitazione si applica alle scritture degli elementi, non ai calcoli eseguiti sui numeri letti dall’array. È una funzionalità del linguaggio, non un’API del browser; la specifica non è una tabella di compatibilità dei browser.
Esempi
const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));Risultato
[255,2,4,255,0]
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.