Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

BigUint64Array : entiers non signés sur 64 bits

BigUint64Array stocke des BigInt comme entiers non signés sur 64 bits et les ramène modulo 2^64.

Version : ECMAScript 2020 onward; example target: Node.js 24.22.2

Syntaxe

new BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])

new BigUint64Array(source?, byteOffset?, length?) crée un typed array non signé de 8 octets par élément. La source peut être une longueur, un itérable ou array-like, BigInt64Array/BigUint64Array ou un tampon ; un typed array numérique a un autre type de contenu et lève TypeError. La forme tampon est une vue sans copie et byteOffset doit être multiple de 8.

L’affectation convertit en BigInt et réduit modulo 2^64 : -1n devient 2^64 - 1 et 2^64 + 5 devient 5n. Un Number ordinaire lève TypeError ; BigInt(number) n’accepte qu’un Number entier, une fraction lève RangeError. L’ordre des octets est natif ; utilisez DataView pour un format fixe.

La longueur passe par ToIndex : les fractions sont tronquées vers zéro, NaN/undefined deviennent 0 et -0.5 donne aussi 0. Résultat négatif après ToIntegerOrInfinity, infinité, plage excessive, décalage mal aligné ou plage hors tampon lève RangeError. Tampon détaché et valeurs incompatibles lèvent TypeError. L’API date d’ECMAScript 2020 ; BYTES_PER_ELEMENT vaut 8.

Exemples

const values = new BigUint64Array([0n, -1n, 2n ** 64n + 5n]);
console.log(Array.from(values, String).join(","));

const buffer = new ArrayBuffer(16);
const view = new BigUint64Array(buffer, 8, 1);
view[0] = 42n;
console.log(view.byteOffset, view.byteLength, view[0], BigUint64Array.BYTES_PER_ELEMENT);

console.log(new BigUint64Array(2.9).length, new BigUint64Array(-0.5).length);
try { values[0] = 1; } catch (error) { console.log(error instanceof TypeError); }
try { new BigUint64Array(new Uint8Array([1])); } catch (error) { console.log(error instanceof TypeError); }

Résultat

0,18446744073709551615,5
8 8 42n 8
2 0
true
true

Sources