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

CKTIS / JavaScript

Tableaux typés : nombre d’éléments, octets de la vue et octets du tampon

Distinguez le tampon (`.buffer`), le nombre d’éléments (`.length`), la taille de la vue en octets (`.byteLength`) et la taille actuelle du tampon entier (`.buffer.byteLength`).

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

Syntaxe

const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer       // backing buffer object
view.length       // element count in the view
view.byteLength   // byte count in the view
buffer.byteLength // current byte count of the entire buffer

view.buffer renvoie le même objet tampon sans copier les données : un ArrayBuffer ou, pour une vue sur une mémoire partagée, un SharedArrayBuffer. view.length compte les éléments, tandis que view.byteLength compte les octets de la vue : view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength donne la taille actuelle du tampon entier en octets, pas sa taille maximale. SharedArrayBuffer a son propre accesseur byteLength. Ce sont des propriétés en lecture seule, pas des méthodes.

new Uint16Array(n) réserve de la mémoire pour n éléments. En revanche, new Uint16Array(buffer, byteOffset, length) crée une vue sans copie : le décalage est exprimé en octets et la longueur en éléments. Un décalage mal aligné ou une plage qui dépasse le tampon déclenche RangeError. Si le destinataire ne doit recevoir que les données de la vue, transmettez une copie de sa plage d’octets, pas view.buffer, qui donne aussi accès aux octets hors de la vue.

Avec un ArrayBuffer redimensionnable (ECMAScript 2024), omettre length fait que la vue couvre autant d’éléments entiers qu’il en tient entre le décalage et la fin du tampon. Une valeur explicite de length fixe la plage de la vue. Réduire le tampon peut mettre la vue hors limites : view.length et view.byteLength renvoient alors 0. Réagrandir le tampon peut rendre la plage de nouveau valide. Vérifiez que l’environnement cible prend en charge le redimensionnement avant de l’utiliser.

Sur le Web, transférer un ArrayBuffer peut détacher le tampon d’origine. view.buffer renvoie toujours le même objet, mais buffer.byteLength, view.length et view.byteLength renvoient 0. Zéro ne suffit pas à prouver un détachement : le tampon ou la vue peut simplement être vide.

Exemples

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);
  console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}

Résultat

true | 3 | 6 | 16

`true | 3 | 6 | 16` confirme que la vue utilise le même tampon : à partir du décalage de 4 octets, elle couvre 3 éléments de 2 octets chacun dans un tampon de 16 octets.

Leçons associées

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

Sources