CKTIS / JavaScript
Uint8ClampedArray — bytes con valores limitados
Uint8ClampedArray es un array tipado que almacena enteros de 0 a 255. Al escribir, limita los valores a ese rango y redondea las fracciones, en lugar de hacer que los valores vuelvan al principio como hace Uint8Array.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray es un tipo estándar de ECMAScript: una vista sobre un búfer cuyos elementos ocupan un byte cada uno y representan enteros sin signo de 0 a 255. Los valores leídos son de tipo Number; no es un Array normal.
Al escribir se aplica ToUint8Clamp: los valores inferiores a 0 pasan a ser 0, y los superiores a 255, 255. Las fracciones se redondean al entero más cercano; si hay un empate exacto, se redondea al entero par. Por eso, 2.5 se convierte en 2 y 3.5 en 4. Esto es distinto de Math.round. NaN se convierte en 0, Infinity en 255 y -Infinity en 0. En cambio, Uint8Array trunca las fracciones y hace que los valores enteros vuelvan al principio con el módulo 256.
new Uint8ClampedArray(length) crea elementos rellenados con ceros, mientras que new Uint8ClampedArray(values) copia y convierte los valores. La forma con buffer crea una vista sobre la memoria existente, sin copiar; crear la vista por sí solo no convierte los bytes almacenados. El constructor requiere new.
El ejemplo muestra la limitación y el redondeo durante la construcción y una asignación posterior. La limitación se aplica al escribir elementos, no a los cálculos realizados con números leídos del array. Es una característica del lenguaje, no una API del navegador; la especificación no es una tabla de compatibilidad de navegadores.
Ejemplos
const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));Resultado
[255,2,4,255,0]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.