CKTIS / JavaScript
Uint8Array — una vista de bytes sin signo
Uint8Array expone los datos de un búfer como enteros sin signo de 8 bits, con valores de 0 a 255. Permite crear y copiar bytes o compartir memoria mediante vistas; las escrituras fuera de rango vuelven al intervalo en vez de limitarse.
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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])Uint8Array es un array tipado: una vista de un búfer cuyos elementos ocupan un byte cada uno y se leen como valores Number de 0 a 255. No es un Array ordinario. La propiedad length indica el número de elementos, byteLength el tamaño de la vista en bytes y buffer expone el búfer subyacente.
new Uint8Array(length) crea un búfer lleno de ceros. new Uint8Array(values) copia valores de un objeto iterable o similar a un array. new Uint8Array(buffer, byteOffset, length) crea una vista de un búfer existente sin copiarlo; byteOffset es un desplazamiento en bytes y length indica el número de elementos. El constructor requiere new.
Al asignar valores, los números finitos se truncan hacia cero y después se reducen módulo 256: 256 pasa a ser 0 y -1 pasa a ser 255. NaN y los infinitos pasan a ser 0. Esto no es una validación de rango ni una limitación como la de Uint8ClampedArray; valida los datos no válidos antes de escribirlos.
subarray() crea una vista que comparte memoria, mientras que slice() crea una copia independiente. En el ejemplo, cambiar view[0] también cambia bytes[1], pero deja copy sin cambios. Esta entrada cubre operaciones básicas de ECMAScript, no métodos de codificación más recientes. La especificación por sí sola no demuestra la compatibilidad con un navegador concreto; que Node 24 esté presente en un repositorio tampoco la demuestra.
Ejemplos
const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);Resultado
0,42,0,255 255,0 4:4
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.