CKTIS / JavaScript
Uint32Array — tableau d’entiers non signés sur 32 bits
Uint32Array est une vue typée sur un tampon : chaque élément occupe 4 octets et stocke un nombre compris entre 0 et 4294967295. Découvrez la conversion des valeurs, la création de vues et la différence entre mémoire partagée et copie.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array est un tableau typé : une vue mémoire dont les éléments sont lus comme des valeurs Number comprises entre 0 et 4294967295. Chaque élément occupe 4 octets ; length compte les éléments, tandis que byteLength compte les octets. Ce n’est pas un Array ordinaire et il ne possède pas de méthode push().
new Uint32Array(length) crée un tampon rempli de zéros. La construction à partir d’un objet itérable ou d’un autre tableau typé dont les éléments sont de type Number copie les valeurs. Si la source est un BigInt64Array ou un BigUint64Array, le constructeur déclenche une TypeError, même si le tableau source est vide. La construction à partir d’un ArrayBuffer partage sa mémoire. byteOffset doit être un multiple de 4 ; une valeur length explicitement fournie compte les éléments, et non les octets.
L’écriture applique la conversion ToUint32 : elle tronque la valeur vers zéro, puis prend le résultat modulo 2 ** 32. Ainsi, -1 devient 4294967295 et 2 ** 32 + 7 devient 7. NaN et les infinis deviennent 0 ; écrire un BigInt déclenche une TypeError. Il s’agit d’une conversion, pas d’une validation de plage.
subarray() partage la mémoire, tandis que slice() copie les éléments. L’ordre des octets dépend de l’implémentation ; utilisez DataView pour les formats binaires qui exigent un ordre explicite. Dans l’exemple, modifier view[0] modifie aussi values[1].
Exemples
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);Résultat
1,42,7,3 4 16 4
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.