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

CKTIS / JavaScript

BigInt64Array : entiers signés sur 64 bits

BigInt64Array stocke des valeurs BigInt comme entiers 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 BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])

new BigInt64Array(source?, byteOffset?, length?) crée un typed array de BigInt signés, avec 8 octets par élément. La source peut être un nombre d’éléments, un itérable ou array-like, un autre typed array de type de contenu BigInt (BigInt64Array ou BigUint64Array) ; un typed array numérique a un type incompatible et lève TypeError ou un ArrayBuffer/SharedArrayBuffer. La forme avec tampon crée une vue sans copie et byteOffset doit être multiple de 8. Les nouveaux éléments valent zéro.

À l’affectation, la valeur est convertie en BigInt, réduite modulo 2^64 et interprétée en complément à deux de -2^63 à 2^63-1. Ainsi 2n ** 63n devient -2n ** 63n. Un Number ordinaire est refusé et lève TypeError ; utilisez BigInt(number) pour une conversion voulue, mais seulement si number est entier ; un Number fractionnaire lève RangeError. Le typed array emploie l’ordre natif des octets ; utilisez DataView pour un format fixe.

Le constructeur exige new. La longueur passe par ToIndex : les fractions sont tronquées vers zéro, NaN et undefined deviennent 0, et -0.5 devient -0, donc 0. Un résultat négatif après ToIntegerOrInfinity, une infinité, un dépassement de plage, un décalage mal aligné ou une plage hors tampon lève RangeError ; tampon détaché ou valeur non convertible lève TypeError. L’API date d’ECMAScript 2020 et BigInt64Array.BYTES_PER_ELEMENT vaut 8.

Exemples

const signed = new BigInt64Array([1n, -2n, 2n ** 63n]);
console.log(Array.from(signed, String).join(","));

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

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

try { signed[0] = 1; } catch (error) { console.log(error instanceof TypeError); }

Résultat

1,-2,-9223372036854775808
5,-1
8 8 42n 8
true

Sources