Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti