DataView.prototype.getBigInt64()

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.

Die getBigInt64()-Methode von DataView-Instanzen liest 8 Bytes ab dem angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-Vorzeichen-Integer. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können von jedem innerhalb der Grenzen liegenden Offset abgerufen werden.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;

const view = new DataView(buffer);
view.setBigInt64(1, max);

console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n

Syntax

js
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)

Parameter

byteOffset

Der Offset in Bytes vom Beginn der Ansicht, von dem die Daten gelesen werden sollen.

littleEndian Optional

Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert sind. Wenn false oder undefined, wird ein Big-Endian-Wert gelesen.

Rückgabewert

Ein BigInt von -263 bis 263-1, inklusive.

Ausnahmen

RangeError

Wird ausgelöst, wenn der byteOffset so eingestellt ist, dass über das Ende der Ansicht hinaus gelesen würde.

Beispiele

Verwendung von getBigInt64()

js
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-dataview.prototype.getbigint64

Browser-Kompatibilität

Siehe auch