BigInt64Array

Baseline Widely available

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ôtDataView. 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éeTypedArray.

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 : 1898875537769492nconsole.log("Longueur de Array :", bigint64.length);// Sortie attendue : Longueur de Array : 3console.log("Longueur en octets de Array :", bigint64.byteLength);// Sortie attendue : Longueur en octets de Array : 24console.log("Décalage en octets de Array :", bigint64.byteOffset);// Sortie attendue : Décalage en octets de Array : 0bigint64.set([100n, 200n], 1);console.log(bigint64);// Sortie attendue : BigInt64Array [6118793953620967n, 100n, 200n]

Constructeur

BigInt64Array(): Crée un nouvel objetBigInt64Array.

Propriétés statiques

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

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

Méthodes statiques

Hérite des méthodes statiques de son parentTypedArray.

Propriétés d'instance

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

Ces propriétés sont définies surBigInt64Array.prototype et sont partagées par toutes les instances deBigInt64Array.

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'unBigInt64Array.
BigInt64Array.prototype.constructor: La fonction constructeur qui a créé l'objet instance. Pour les instances deBigInt64Array, la valeur initiale est le constructeurBigInt64Array.

// Construction à partir d'une longueurconst bigint64 = new BigInt64Array(2);bigint64[0] = 42n;console.log(bigint64[0]); // 42nconsole.log(bigint64.length); // 2console.log(bigint64.BYTES_PER_ELEMENT); // 8// Construction à partir d'un tableauconst 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 ArrayBufferconst buffer = new ArrayBuffer(64);const z = new BigInt64Array(buffer, 8, 4);console.log(z.byteOffset); // 8// Construction à partir d'un itérableconst iterable = (function* () {  yield* [1n, 2n, 3n];})();const bigint64FromIterable = new BigInt64Array(iterable);console.log(bigint64FromIterable);// BigInt64Array[1n, 2n, 3n]