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

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
getBigInt64

Legend

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

Full support
Full support

Siehe auch