CKTIS / JavaScript
Uint8ClampedArray — octets avec valeurs limitées
Uint8ClampedArray est un tableau typé qui stocke des entiers de 0 à 255. Lors d’une écriture, il limite les valeurs à cette plage et arrondit les fractions, au lieu de les faire boucler comme Uint8Array.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray est un type standard d’ECMAScript : une vue sur un tampon dont chaque élément occupe un octet et représente un entier non signé de 0 à 255. Les valeurs lues sont de type Number ; il ne s’agit pas d’un tableau Array ordinaire.
Les écritures appliquent ToUint8Clamp : les valeurs inférieures à 0 deviennent 0, et celles supérieures à 255 deviennent 255. Les fractions sont arrondies à l’entier le plus proche ; en cas d’égalité exacte, l’arrondi se fait vers l’entier pair. Ainsi, 2.5 devient 2 et 3.5 devient 4. Cette règle diffère de Math.round. NaN devient 0, Infinity devient 255 et -Infinity devient 0. Uint8Array, en revanche, tronque les fractions et fait boucler les entiers modulo 256.
new Uint8ClampedArray(length) crée des éléments initialisés à zéro, tandis que new Uint8ClampedArray(values) copie et convertit les valeurs. La forme avec buffer crée une vue sur la mémoire existante, sans copie ; créer la vue ne convertit pas à lui seul les octets stockés. Le constructeur exige new.
L’exemple montre la limitation et l’arrondi lors de la construction, puis d’une affectation ultérieure. La limitation s’applique aux écritures d’éléments, et non aux calculs effectués sur les nombres lus dans le tableau. Il s’agit d’une fonctionnalité du langage, et non d’une API de navigateur ; la spécification n’est pas un tableau de compatibilité des navigateurs.
Exemples
const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));Résultat
[255,2,4,255,0]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.