Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

DataView : méthode getUint16()

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.

La méthode getUint16() des instances de DataView lit 2 octets à partir du décalage d'octet défini de cette DataView et les interprète comme un entier non-signé sur 16 bits. Il n'y a pas de contrainte d'alignement ; les valeurs sur plusieurs octets peuvent être obtenues depuis n'importe quel décalage valide.

Exemple interactif

// Créer un ArrayBuffer avec une taille en octets
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setUint16(1, 65535); // Entier non-signé sur 16 bits maximum

console.log(view.getUint16(1));
// Résultat attendu : 65535

Syntaxe

js
getUint16(byteOffset)
getUint16(byteOffset, littleEndian)

Paramètres

byteOffset

La position, exprimée en nombre d'octets depuis le début de la vue, à laquelle lire les données.

littleEndian Facultatif

Indique si les données sont stockées au format gros-boutiste ou petit-boutiste. Si la valeur est false ou undefined, une valeur gros-boutiste est lue.

Valeur de retour

Un entier compris entre 0 et 65535 inclus.

Exceptions

RangeError

Levée si le paramètre byteOffset est défini de façon à lire au-delà de la fin de la vue.

Exemples

Utiliser la méthode getUint16()

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

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-dataview.prototype.getuint16

Compatibilité des navigateurs

Voir aussi