Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes