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

CKTIS / JavaScript

Uint32Array — arreglo de enteros sin signo de 32 bits

Uint32Array es una vista tipada de un búfer: cada elemento ocupa 4 bytes y almacena un número entre 0 y 4294967295. Aprende cómo se convierten los valores, cómo se crean las vistas y en qué se diferencian compartir memoria y copiar.

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 Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])

Uint32Array es un arreglo tipado: una vista de memoria cuyos elementos se leen como valores Number entre 0 y 4294967295. Cada uno ocupa 4 bytes; length cuenta elementos, mientras que byteLength cuenta bytes. No es un Array ordinario y no tiene un método push().

new Uint32Array(length) crea un búfer rellenado con ceros. Al construirlo a partir de un objeto iterable o de otro arreglo tipado con elementos de tipo Number, se copian los valores. Si el origen es un BigInt64Array o un BigUint64Array, el constructor lanza un TypeError, incluso si el arreglo de origen está vacío. Al construirlo a partir de un ArrayBuffer, se comparte la memoria de ese búfer. byteOffset debe ser múltiplo de 4; un length explícito cuenta elementos, no bytes.

Al escribir se aplica la conversión ToUint32: se trunca hacia cero y luego se toma el resultado módulo 2 ** 32. Así, -1 se convierte en 4294967295 y 2 ** 32 + 7 en 7. NaN y los infinitos se convierten en 0; escribir un BigInt provoca un TypeError. Esto es una conversión, no una validación de rango.

subarray() comparte la memoria, mientras que slice() copia los elementos. El orden de los bytes es propio de la implementación; usa DataView para formatos binarios que requieran un orden de bytes explícito. En el ejemplo, cambiar view[0] también cambia values[1].

Ejemplos

const values = new Uint32Array([1, -1, 2 ** 32 + 7, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(values.length, values.byteLength, Uint32Array.BYTES_PER_ELEMENT);

Resultado

1,42,7,3
4 16 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.

Fuentes