Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

TypedArray : tampon, décalage, taille en octets et nombre d’éléments

Distinguez le tampon entier de la plage d’octets et du nombre d’éléments de la vue, puis voyez ce que renvoient ses propriétés après un redimensionnement ou un détachement.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

view.buffer
view.byteOffset
view.byteLength
view.length

new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)

Une instance comme Uint16Array est une vue sur un tampon. TypedArray désigne la famille de types : il n’existe pas de constructeur global de ce nom à appeler directement. Les quatre propriétés sont des accesseurs hérités sans mutateur. Appeler l’un de leurs getters sur un objet qui n’est pas un tableau typé déclenche TypeError. view.length ne doit pas être confondu avec Uint16Array.length, le nombre de paramètres déclarés du constructeur.

view.buffer renvoie l’objet ArrayBuffer ou SharedArrayBuffer sous-jacent, sans le copier. view.byteOffset indique où commence la vue par rapport au début du tampon et view.byteLength indique sa taille, en octets dans les deux cas. view.length compte les éléments. Si les deux lectures correspondent à la même taille de vue, l’égalité view.byteLength === view.length * view.BYTES_PER_ELEMENT est vraie. Les getters sont appelés séparément : si un autre agent agrandit le SharedArrayBuffer sous-jacent entre les deux lectures, les getters d’une vue de longueur adaptative peuvent observer des tailles différentes et la comparaison peut renvoyer false. view.buffer.byteLength mesure le tampon entier, pas seulement la vue.

Dans new Uint16Array(buffer, byteOffset, length), le deuxième argument est en octets et le troisième en éléments. Un décalage mal aligné ou une plage qui dépasse le tampon déclenche RangeError. Les écritures sont visibles dans les vues qui se chevauchent sur le même tampon. Transmettre une vue ne masque pas les autres octets : pour ne divulguer qu’une plage valide, copiez ses octets dans un tampon distinct.

Sur un tampon de taille fixe, omettre length couvre le reste du tampon, qui doit contenir un nombre entier d’éléments. Sur un ArrayBuffer redimensionnable ou un SharedArrayBuffer extensible, omettre length ou passer undefined crée une vue de longueur adaptative : elle compte les éléments entiers qui tiennent à partir de son décalage. Un nombre d’éléments explicite fixe la longueur de la vue.

Réduire le tampon peut mettre la vue hors limites ; l’agrandir de nouveau peut la ramener dans les limites. Si la vue est hors limites ou si son ArrayBuffer est détaché (par exemple lors d’un transfert), les trois getters numériques renvoient 0, mais buffer renvoie toujours le même objet. Une vue vide valide peut avoir un décalage non nul. Le redimensionnement et l’agrandissement sont spécifiés dans ECMAScript 2024 ; vérifiez leur prise en charge dans l’environnement cible.

Exemples

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);

  console.log([
    view.buffer === buffer,
    view.byteOffset,
    view.byteLength,
    view.length,
    view.buffer.byteLength,
  ].join(" "));

  view[0] = 513;
  console.log(String(new Uint16Array(buffer)[2]));
}

Résultat

true 4 6 3 16
513

La vue commence à l’octet 4 et couvre trois éléments de deux octets, soit 6 octets sur 16. L’écriture à l’indice 0 est visible à l’indice 2 de la vue sur le tampon entier.

Leçons associées

  • JavaScript · Leçon 2 · Avancé · Version : 4

Sources