Constructeur DataView()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Le constructeur DataView() permet de construire des objets DataView.
Exemple interactif
// Créer un ArrayBuffer avec une taille en octets
const buffer = new ArrayBuffer(16);
// Créer deux vues
const view1 = new DataView(buffer);
const view2 = new DataView(buffer, 12, 4); // À partir de l'octet 12 pour les 4 octets suivants
view1.setInt8(12, 42); // Mettre 42 dans l'emplacement 12
console.log(view2.getInt8(0));
// Résultat attendu : 42
Syntaxe
new DataView(buffer)
new DataView(buffer, byteOffset)
new DataView(buffer, byteOffset, byteLength)
Paramètres
buffer-
Un objet
ArrayBufferouSharedArrayBufferexistant à utiliser comme tampon de mémoire sur lequel portera la vue formée par le nouvel objetDataView. byteOffsetFacultatif-
Le décalage, exprimé en octets, du premier octet référencé par la vue par rapport au tampon de mémoire. Par défaut, la vue commence au premier octet du tampon de mémoire.
byteLengthFacultatif-
Le nombre d'éléments dans le tableau des octets de la vue. Par défaut, la longueur de la vue correspondra à celle du tampon.
Valeur de retour
Un nouvel objet DataView représentant le tampon de données défini.
Exceptions
RangeError-
Levée si les valeurs des paramètres
byteOffsetoubyteLengthfont que la vue dépasse la fin du tampon. En d'autres termes,byteOffset + byteLength > buffer.byteLength.
Exemples
Utiliser DataView()
const buffer = new ArrayBuffer(16);
const view = new DataView(buffer, 0);
view.setInt16(1, 42);
view.getInt16(1); // 42
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview-constructor |