DataView.prototype.setBigUint64()

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.

La méthode setBigUint64() permet d'enregister un entier non-signé sur 64 bits (type unsigned long long par analogie avec C) à l'octet indiqué par rapport au début de la DataView.

Exemple interactif

// 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

Syntaxe

js
dataview.setBigUint64(positionOctet, value [, littleEndian])

Paramètres

positionOctet

La position, exprimée en nombre d'octets, à partir du début de la vue à laquelle enregistrer la donnée.

valeur

La valeur à enregistrer

littleEndian

Facultatif Indique si la donnée sur 64 bits est enregistrée dans l'ordre des octets de poids faibles. Si ce paramètre vaut false ou undefined, l'ordre sera celui des octets de poids forts.

Valeur de retour

Erreurs renvoyées

RangeError

Renvoyée si positionOctet est tel que l'enregistrement sera fait en dehors de la vue.

Exemples

Utilisation de la méthode setBigUint64()

js
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getInt32(0); // 3n

Spécifications

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

Compatibilité des navigateurs

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
setBigUint64

Legend

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

Full support
Full support

Voir aussi