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 Methode getBigInt64() von DataView-Instanzen liest 8 Bytes ab dem angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-ganzzahligen Wert mit Vorzeichen. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können von jedem Offset innerhalb der Grenzen 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 im Bereich von -263 bis 263-1, einschließlich.

Ausnahmen

RangeError

Wird ausgelöst, wenn der byteOffset so gesetzt wird, dass er über das Ende der Ansicht hinausliest.

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® 2025 Language Specification
# sec-dataview.prototype.getbigint64

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch