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

CKTIS / JavaScript

Longueur et indexation des tableaux typés

`length` compte les éléments de la vue, et non ses octets. Les indices commencent à zéro, et une écriture au-delà du dernier élément n’agrandit pas la vue.

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

Syntaxe

view.length
view[index]
view[index] = value
view.at(index)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)

Un tableau typé, tel que Uint16Array, est une vue sur un tampon. view.length est une propriété héritée avec un accesseur en lecture, mais sans accesseur en écriture. Elle compte les éléments ; view.byteLength compte les octets de la vue et view.buffer.byteLength ceux du tampon entier. Une affectation à view.length ne redimensionne pas la vue et lève une TypeError en mode strict.

Les indices d’éléments sont les entiers de 0 à view.length - 1. view[0] et view["0"] désignent le même élément. Les clés "01" et "1.0" sont des noms de propriétés ordinaires, pas des indices d’éléments. view[-0] se comporte comme view[0], mais view["-0"] renvoie undefined.

Une lecture à un indice d’élément invalide renvoie undefined. Une écriture à cet indice ne modifie pas le tampon et n’ajoute aucun élément, même en mode strict, si la conversion de la valeur réussit. Cette conversion peut toutefois lever une exception, par exemple si l’on écrit un Number dans un BigInt64Array. À un indice valide, la valeur est stockée selon le type des éléments. view[-1] ne compte pas depuis la fin ; view.at(-1) le fait et renvoie le dernier élément d’une vue non vide.

Si le constructeur reçoit un ArrayBuffer redimensionnable ou un SharedArrayBuffer extensible, omettre le troisième argument length (ou passer undefined) crée une vue dont la longueur s’ajuste au nombre d’éléments entiers entre byteOffset et la fin actuelle du tampon. Avec un tampon de taille fixe, le même appel crée une vue de longueur fixe. Dans ce cas, le nombre d’octets entre byteOffset et la fin du tampon doit être un multiple de la taille d’un élément en octets ; sinon, le constructeur lève une RangeError. Une longueur explicite fixe ce nombre tant que la vue tient dans le tampon. Si le tampon rétrécit et que la vue sort de ses limites, length vaut 0 ; un agrandissement peut ramener la vue dans les limites. Le détachement du tampon donne aussi length === 0. Dans les deux cas, les lectures indexées renvoient undefined, mais at() lève une TypeError.

Exemples

"use strict";
{
  const view = new Uint16Array([10, 20]);
  view[1] = 65537;
  view[view.length] = 99;

  console.log(`${view.length} ${view.byteLength}`);
  console.log(`${view[0]} ${view[1]}`);
  console.log(`${view[view.length]} ${view[-1]} ${view.at(-1)}`);
}

Résultat

2 4
10 1
undefined undefined 1

Deux éléments de `Uint16Array` occupent quatre octets. Stocker `65537` donne `1`, car seuls les 16 bits de poids faible sont conservés. Écrire à l’indice `2` n’agrandit pas la vue ; `at(-1)` lit le dernier élément.

Leçons associées

  • JavaScript · Leçon 33 · Avancé · Version : 4
  • JavaScript · Leçon 34 · Avancé · Version : 4

Sources