DataView.prototype.getBigUint64()

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 getBigUint64() von DataView-Instanzen liest 8 Byte, beginnend bei dem angegebenen Byte-Offset dieses DataView, und interpretiert sie als 64-Bit-unsigned-Integer. Es gibt keine Ausrichtungsbeschränkung; Mehr-Byte-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 an unsigned 64-bit integer
const max = 2n ** 64n - 1n;

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

console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n

Syntax

js
getBigUint64(byteOffset)
getBigUint64(byteOffset, littleEndian)

Parameter

byteOffset

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

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 0 bis 264-1, einschließlich.

Ausnahmen

RangeError

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

Beispiele

Verwendung von getBigUint64()

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

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-dataview.prototype.getbiguint64

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch