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 von BigInt64Array.

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 von BigInt64Array.

BigInt64Array.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für BigInt64Array-Instanzen ist der anfängliche Wert der BigInt64Array-Konstruktor.

Instanz-Methoden

Erbt Instanz-Methoden von seinem 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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
BigInt64Array
BigInt64Array() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch