BigInt64Array

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Das BigInt64Array typisierte Array repräsentiert ein Array von 64-Bit-Ganzzahlen im Vorzeichen mit der Byte-Reihenfolge der Plattform. Wenn eine Kontrolle über die Byte-Reihenfolge benötigt wird, verwenden Sie stattdessen DataView. Der Inhalt wird auf 0n initialisiert, sofern keine Initialisierungsdaten explizit bereitgestellt werden. Sobald das Objekt erstellt ist, können Sie auf die Elemente im Array mithilfe der Methoden des Objekts oder mit der Standard-Array-Index-Syntax (d.h. mit Klammernotation) zugreifen.

BigInt64Array ist eine Unterklasse der verborgenen TypedArray Klasse.

Probieren Sie es aus

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);
// Expected Output: BigInt64Array [6118793953620967n, 1881938909131133n, 1898875537769492n]

console.log(bigint64[2]);
// Expected Output: 1898875537769492n

console.log("Array length:", bigint64.length);
// Expected Output: Array length: 3

console.log("Array byte length:", bigint64.byteLength);
// Expected Output: Array byte length: 24

console.log("Array byte offset:", bigint64.byteOffset);
// Expected Output: Array byte offset: 0

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

Konstruktor

BigInt64Array()

Erzeugt ein neues BigInt64Array-Objekt.

Statische Eigenschaften

Erbt auch statische Eigenschaften von ihrem Elternteil TypedArray.

BigInt64Array.BYTES_PER_ELEMENT

Gibt einen Zahlenwert der Elementgröße zurück. 8 im Fall von BigInt64Array.

Statische Methoden

Erbt statische Methoden von ihrem Elternteil TypedArray.

Instanz-Eigenschaften

Erbt auch Instanz-Eigenschaften von ihrem Elternteil TypedArray.

Diese Eigenschaften sind auf BigInt64Array.prototype definiert und werden von allen BigInt64Array-Instanzen gemeinsam genutzt.

BigInt64Array.prototype.BYTES_PER_ELEMENT

Gibt einen Zahlenwert der Elementgröße zurück. 8 im Fall eines BigInt64Array.

BigInt64Array.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für BigInt64Array Instanzen ist der Anfangswert der BigInt64Array Konstruktor.

Instanz-Methoden

Erbt Instanz-Methoden von ihrem Elternteil TypedArray.

Beispiele

Verschiedene Möglichkeiten, ein BigInt64Array zu erstellen

js
// From a length
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

// From an array
const x = new BigInt64Array([21n, 31n]);
console.log(x[1]); // 31n

// From another TypedArray
const y = new BigInt64Array(x);
console.log(y[0]); // 21n

// From an ArrayBuffer
const buffer = new ArrayBuffer(64);
const z = new BigInt64Array(buffer, 8, 4);
console.log(z.byteOffset); // 8

// From an iterable
const iterable = (function* () {
  yield* [1n, 2n, 3n];
})();
const bigint64FromIterable = new BigInt64Array(iterable);
console.log(bigint64FromIterable);
// BigInt64Array [1n, 2n, 3n]

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-typedarray-objects

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch