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
getypte Array stellt ein Array von 64-Bit vorzeichenbehafteten Ganzzahlen in der Byte-Reihenfolge der Plattform dar. Wenn Kontrolle über die Byte-Reihenfolge erforderlich ist, verwenden Sie stattdessen DataView
. Der Inhalt wird auf 0n
initialisiert, es sei denn, es werden explizit Initialisierungsdaten bereitgestellt. Einmal erstellt, können Sie auf Elemente im Array über die Methoden des Objekts oder die Standard-Array-Indexsyntax (d. h. mit eckigen Klammern) zugreifen.
BigInt64Array
ist eine Unterklasse der versteckten 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()
-
Erstellt ein neues
BigInt64Array
-Objekt.
Statische Eigenschaften
Erbt auch statische Eigenschaften von seinem Elternteil TypedArray
.
BigInt64Array.BYTES_PER_ELEMENT
-
Gibt einen numerischen Wert für die Elementgröße zurück.
8
im Fall vonBigInt64Array
.
Statische Methoden
Erbt statische Methoden von seinem Elternteil TypedArray
.
Instanz-Eigenschaften
Erbt auch Instanz-Eigenschaften von seinem Elternteil TypedArray
.
Diese Eigenschaften sind auf BigInt64Array.prototype
definiert und werden von allen BigInt64Array
-Instanzen geteilt.
BigInt64Array.prototype.BYTES_PER_ELEMENT
-
Gibt einen numerischen Wert für die Elementgröße zurück.
8
im Fall vonBigInt64Array
. BigInt64Array.prototype.constructor
-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
BigInt64Array
-Instanzen ist der anfängliche Wert derBigInt64Array
-Konstruktor.
Instanz-Methoden
Erbt Instanz-Methoden von seinem Elternteil TypedArray
.
Beispiele
Verschiedene Möglichkeiten, ein BigInt64Array zu erstellen
// 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
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
BigInt64Array | ||||||||||||||
BigInt64Array() constructor |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support