DataView

Résumé

La vue DataView fournit une interface de bas niveau pour lire et écrire des données depuis/dans un ArrayBuffer.

Syntaxe

new DataView(buffer [, décalageOctets [, longueurOctets]])

Paramètres

buffer

Un ArrayBuffer existant à utiliser pour la mise en mémoire du nouvel objet DataView.

décalageOctets Facultatif

Le décalage, exprimé en octets, pour trouver le premier octet significatif du buffer à représenter dans la vue. Si ce paramètre n'est pas fourni, la vue commencera au premier octet du buffer.

longueurOctets Facultatif

Le nombre d'éléments dans le tableau d'octets. Si ce paramètre n'est pas fourni, la longueur de la vue correspondra à celle du buffer.

Valeur de retour

Un nouvel objet DataView représentant le tampon mémoire (buffer) fourni.

Erreurs renvoyées

RangeError

Renvoyée si les paramètres décalageOctets et longueurOctets dépassent la fin du buffer fourni.

Description

Détecter le boutisme (endianness)

En utilisant cet objet, vous pouvez détecter le type d'architecture qui exécute votre script, ce qui peut être utile dans certains cas. Voici un fragment de code pour permettre cette détection. Voir Endianness pour plus d'informations.

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

Propriétés

DataView.length

La longueur du constructeur DataView qui vaut 3.

DataView.prototype

Permet d'ajouter des propriétés à tous les objets DataView.

Instances de DataView

Chacune des instances de DataView hérite de DataView.prototype.

Propriétés

Méthodes

Exemples

// Exemples nécessaires

Spécifications

Compatibilité des navigateurs

Voir aussi

• jDataView : une bibliothèque JavaScript qui émule (polyfill) et étend l'API DataView pour tous les navigateurs et pour Node.js.