BigInt64Array

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2021.

Le tableau typé BigInt64Array représente un tableau d'entiers signés sur 64 bits dans l'ordre d'octets de la plateforme. Si vous avez besoin de contrôler l'ordre des octets, utilisez plutôt DataView. Le contenu est initialisé à 0n sauf si des données d'initialisation sont fournies explicitement. Une fois créé, vous pouvez accéder aux éléments du tableau en utilisant les méthodes de l'objet ou la syntaxe d'indice standard (c'est‑à‑dire la notation entre crochets).

BigInt64Array est une sous-classe de la classe cachée TypedArray.

Dans cet article

Exemple interactif

const buffer = new ArrayBuffer(24);
const bigint64 = new BigInt64Array(buffer);
bigint64[0] = 5886014448488689n;
bigint64[1] = 1881938909131133n;
bigint64[2] = 1898875537769492n;

bigint64[0] = 6118793953620967n;
console.log(bigint64);
// Sortie attendue : BigInt64Array [6118793953620967n, 1881938909131133n, 1898875537769492n]

console.log(bigint64[2]);
// Sortie attendue : 1898875537769492n

console.log("Longueur de Array :", bigint64.length);
// Sortie attendue : Longueur de Array : 3

console.log("Longueur en octets de Array :", bigint64.byteLength);

// Sortie attendue : Longueur en octets de Array : 24
console.log("Décalage en octets de Array :", bigint64.byteOffset);
// Sortie attendue : Décalage en octets de Array : 0

bigint64.set([100n, 200n], 1);
console.log(bigint64);
// Sortie attendue : BigInt64Array [6118793953620967n, 100n, 200n]

Constructeur

BigInt64Array()

Crée un nouvel objet BigInt64Array.

Propriétés statiques

Hérite également des propriétés statiques de son parent TypedArray.

BigInt64Array.BYTES_PER_ELEMENT

Retourne un nombre indiquant la taille d'un élément. 8 dans le cas de BigInt64Array.

Méthodes statiques

Hérite des méthodes statiques de son parent TypedArray.

Propriétés d'instance

Hérite également des propriétés d'instance de son parent TypedArray.

Ces propriétés sont définies sur BigInt64Array.prototype et sont partagées par toutes les instances de BigInt64Array.

BigInt64Array.prototype.BYTES_PER_ELEMENT

Cette propriété retourne un nombre correspondant à la quantité d'octets pour un élément du tableau. 8 dans le cas d'un BigInt64Array.

BigInt64Array.prototype.constructor

La fonction constructeur qui a créé l'objet instance. Pour les instances de BigInt64Array, la valeur initiale est le constructeur BigInt64Array.

js
// Construction à partir d'une longueur
const bigint64 = new BigInt64Array(2);
bigint64[0] = 42n;
console.log(bigint64[0]); // 42n
console.log(bigint64.length); // 2
console.log(bigint64.BYTES_PER_ELEMENT); // 8

// Construction à partir d'un tableau
const x = new BigInt64Array([21n, 31n]);
console.log(x[1]); // 31n

// Construction à partir d'un tableau typé
const y = new BigInt64Array(x);
console.log(y[0]); // 21n

// Construction à partir d'un ArrayBuffer
const buffer = new ArrayBuffer(64);
const z = new BigInt64Array(buffer, 8, 4);
console.log(z.byteOffset); // 8

// Construction à partir d'un itérable
const iterable = (function* () {
  yield* [1n, 2n, 3n];
})();
const bigint64FromIterable = new BigInt64Array(iterable);
console.log(bigint64FromIterable);
// BigInt64Array[1n, 2n, 3n]

Le guide des tableaux typés en JavaScript
L'objet TypedArray
L'objet ArrayBuffer
L'objet DataView

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 16 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

BigInt64Array

Dans cet article

Exemple interactif

Constructeur

Propriétés statiques

Méthodes statiques

Propriétés d'instance

Méthodes d'instance

Exemples

Différentes façons de créer un objet BigInt64Array

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN