Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Constructeur 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 constructeur BigInt64Array() crée des objets BigInt64Array. Les éléments sont initialisés à 0n sauf si des données d'initialisation sont fournies explicitement.

Syntaxe

js
new BigInt64Array()
new BigInt64Array(length)
new BigInt64Array(typedArray)
new BigInt64Array(object)

new BigInt64Array(buffer)
new BigInt64Array(buffer, byteOffset)
new BigInt64Array(buffer, byteOffset, length)

Note : BigInt64Array() ne peut être construit qu'avec new. Tenter de l'appeler sans new provoque une erreur TypeError.

Paramètres

Voir TypedArray.

Exceptions

Voir TypedArray.

Exemples

Différentes façons de créer un objet 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]

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-typedarray-constructors

Compatibilité des navigateurs

Voir aussi