DataView : propriété byteOffset

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 propriété accesseur byteOffset des instances de DataView retourne le décalage (en octets) de la vue du début de l'objet ArrayBuffer ou SharedArrayBuffer correspondant.

Exemple interactif

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

const view = new DataView(buffer, 12, 4); // À partir de l'octet 12 pour les 4 octets suivants

console.log(view.byteOffset);
// Résultat attendu : 12

La propriété byteOffset est une propriété accesseur dont la fonction d'accesseur d'écriture est undefined, ce qui signifie que vous pouvez uniquement lire cette propriété. La valeur est définie lors de la construction du DataView et ne peut pas être modifiée. Cependant, la valeur de byteOffset devient 0 si le tampon sous-jacent est redimensionné de sorte que la plage visualisée n'est plus valide.

Exemples

Utiliser la propriété `byteOffset`

const buffer = new ArrayBuffer(8);
const dataview = new DataView(buffer);
dataview.byteOffset; // 0 (aucun décalage)

const dataview2 = new DataView(buffer, 3);
dataview2.byteOffset; // 3 (décalage défini lors de la construction de la vue)

const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });
const dataviewLengthTracking = new DataView(buffer2, 4);
dataviewLengthTracking.byteOffset; // 4
buffer2.resize(3);
dataviewLengthTracking.byteOffset; // 0 (la plage visualisée n'est plus valide)