DataView

Les formats numériques sur plusieurs octets sont représentés différemment en mémoire selon l'architecture de la machine (voir la page du glossaire sur le boutisme pour plus d'explications). Les accesseurs DataView permettent de contrôler explicitement la façon dont se fait l'accès aux données, quel que soit le boutisme de l'ordinateur.

var littleEndian = (function () {
  var buffer = new ArrayBuffer(2);
  new DataView(buffer).setInt16(0, 256, true /* littleEndian */);
  // Int16Array utilise le boutisme de la plateforme
  return new Int16Array(buffer)[0] === 256;
})();
console.log(littleEndian); // true ou false

Certains navigateurs ne prennent pas en charge DataView.prototype.setBigInt64() et DataView.prototype.setBigUint64(). Pour que les opérations sur 64 bits fonctionnent pour ces navigateurs, il est possible d'implémenter une fonction getUint64() qui permet d'obtenir des valeurs avec une précision correcte jusqu'à Number.MAX_SAFE_INTEGER, ce qui peut être suffisant selon le cas d'usage.

function getUint64(dataview, byteOffset, littleEndian) {
  // on décompose la valeur 64 sur bits en deux nombres 32 bits
  const gauche = dataview.getUint32(byteOffset, littleEndian);
  const droite = dataview.getUint32(byteOffset + 4, littleEndian);

  // on combine les deux valeurs 32 bits
  const combinaison = littleEndian
    ? gauche + 2 ** 32 * droite
    : 2 ** 32 * gauche + droite;
  if (!Number.isSafeInteger(combinaison)) {
    console.warn(
      combinaison,
      " dépasse MAX_SAFE_INTEGER : perte de précision !",
    );
  }
  return combinaison;
}

On peut également créer un objet BigInt si on veut avoir accès à 64 bits. Sur le plan des performances, les grands entiers (BigInt ont une taille variable, aussi leur manipulation sera nécessairement plus lente que celle des nombres stockés sur 32 bits. Ceci étant écrit, les valeurs natives BigInt seront plus performantes que les implémentations tierces (bibliothèques, etc.).

const BigInt = window.BigInt,
  bigThirtyTwo = BigInt(32),
  bigZero = BigInt(0);
function getUint64BigInt(dataview, byteOffset, littleEndian) {
  // on décompose la valeur 64 sur bits en deux nombres 32 bits (4 octets)
  const gauche = BigInt(
    dataview.getUint32(byteOffset | 0, !!littleEndian) >>> 0,
  );
  const droite = BigInt(
    dataview.getUint32(((byteOffset | 0) + 4) | 0, !!littleEndian) >>> 0,
  );

  // on recombine les deux valeurs sur 32 bits et on la renvoie
  return littleEndian
    ? (droite << bigThirtyTwo) | gauche
    : (gauche << bigThirtyTwo) | droite;
}

DataView()

Crée un nouvel objet DataView.

DataView.prototype.buffer

L'objet ArrayBuffer référencé par la vue courante. Cette propriété est déterminée au moment de la construction et est donc uniquement accessible en lecture seule.

DataView.prototype.byteLength

La longueur, exprimée en octets, de cette vue, à partir du début de l'objet ArrayBuffer correspondant. Cette propriété est déterminée au moment de la construction et est donc uniquement accessible en lecture seule.

DataView.prototype.byteOffset

Le décalage, exprimé en octets, de cette vue, par rapport au début de l'objet ArrayBuffer correspondant. Cette propriété est déterminée au moment de la construction et est donc uniquement accessible en lecture seule.

DataView.prototype.getInt8()

Obtient un entier signé sur 8 bits (équivalent au type byte) situé à l'octet relatif au début de la vue.

DataView.prototype.getUint8()

Obtient un entier non-signé sur 8 bits (équivalent au type unsigned byte) situé à l'octet relatif au début de la vue.

DataView.prototype.getInt16()

Obtient un entier signé sur 16 bits (équivalent au type short) situé à l'octet relatif au début de la vue.

DataView.prototype.getUint16()

Obtient un entier non-signé sur 16 bits (équivalent au type unsigned short) situé à l'octet relatif au début de la vue.

DataView.prototype.getInt32()

Obtient un entier signé sur 32 bits (équivalent au type long) situé à l'octet relatif au début de la vue.

DataView.prototype.getUint32()

Obtient un entier non-signé sur 32 bits (équivalent au type unsigned long) situé à l'octet relatif au début de la vue.

DataView.prototype.getFloat32()

Obtient un nombre flottant signé sur 32 bits (équivalent au type float) situé à l'octet relatif au début de la vue.

DataView.prototype.getFloat64()

Obtient un nombre flottant signé sur 64 bits (équivalent au type double) situé à l'octet relatif au début de la vue.

DataView.prototype.getBigInt64()

Obtient un entier signé sur 64 bits (équivalent au type long long) situé à l'octet relatif au début de la vue.

DataView.prototype.getBigUint64()

Obtient un entier non-signé sur 64 bits (équivalent au type unsigned long long) situé à l'octet relatif au début de la vue.

DataView.prototype.setInt8()

Enregistre un entier signé sur 8 bits (équivalent au type byte) situé à l'octet relatif au début de la vue.

DataView.prototype.setUint8()

Enregistre un entier non-signé sur 8 bits (équivalent au type unsigned byte) situé à l'octet relatif au début de la vue.

DataView.prototype.setInt16()

Enregistre un entier signé sur 16 bits (équivalent au type short) situé à l'octet relatif au début de la vue.

DataView.prototype.setUint16()

Enregistre un entier non-signé sur 16 bits (équivalent au type unsigned short) situé à l'octet relatif au début de la vue.

DataView.prototype.setInt32()

Enregistre un entier signé sur 32 bits (équivalent au type long) situé à l'octet relatif au début de la vue.

DataView.prototype.setUint32()

Enregistre un entier non-signé sur 32 bits (équivalent au type unsigned long) situé à l'octet relatif au début de la vue.

DataView.prototype.setFloat32()

Enregistre un entier signé sur 32 bits (équivalent au type float) situé à l'octet relatif au début de la vue.

DataView.prototype.setFloat64()

Enregistre un entier signé sur 64 bits (équivalent au type double) situé à l'octet relatif au début de la vue.

DataView.prototype.setBigInt64()

Enregistre un entier signé sur 64 bits (équivalent au type long long) situé à l'octet relatif au début de la vue.

DataView.prototype.setBigUint64()

Enregistre un entier non-signé sur 64 bits (équivalent au type unsigned long long) situé à l'octet relatif au début de la vue.

• Prothèse d'émulation pour DataView dans core-js
• jDataView : une bibliothèque JavaScript qui ajoute des prothèses et des extensions à l'API DataView afin de pouvoir la manipuler au travers des différents navigateurs et de Node.js.
• ArrayBuffer
• SharedArrayBuffer