CKTIS / JavaScript
Uint32Array — matriz de inteiros sem sinal de 32 bits
Uint32Array é uma vista tipada sobre um buffer: cada elemento ocupa 4 bytes e armazena um número entre 0 e 4294967295. Descubra como funciona a conversão de valores, a criação de vistas e a diferença entre partilhar memória e copiar.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array é uma matriz tipada: uma vista da memória cujos elementos são lidos como valores Number entre 0 e 4294967295. Cada elemento ocupa 4 bytes; length conta elementos, enquanto byteLength conta bytes. Não é uma matriz Array normal e não tem o método push().
new Uint32Array(length) cria um buffer preenchido com zeros. A construção a partir de um objeto iterável ou de outra matriz tipada com elementos do tipo Number copia os valores. Se a origem for um BigInt64Array ou um BigUint64Array, o construtor lança um TypeError, mesmo que a matriz de origem esteja vazia. A construção a partir de um ArrayBuffer partilha a respetiva memória. byteOffset tem de ser múltiplo de 4; um length explícito conta elementos, não bytes.
Ao escrever, é aplicada a conversão ToUint32: o valor é truncado em direção a zero e, em seguida, calcula-se o resultado módulo 2 ** 32. Assim, -1 passa a 4294967295 e 2 ** 32 + 7 passa a 7. NaN e os infinitos passam a 0; escrever um BigInt gera um TypeError. Trata-se de uma conversão, não de uma validação do intervalo.
subarray() partilha a memória, enquanto slice() copia os elementos. A ordem dos bytes depende da implementação; utilize DataView para formatos binários que exijam uma ordem explícita dos bytes. No exemplo, alterar view[0] também altera values[1].
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.