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

CKTIS / JavaScript

Longueur et indexation des tableaux en JavaScript

`length` définit la plage de positions d’un tableau, pas le nombre d’éléments présents. Une écriture par indice peut l’allonger, tandis qu’un raccourcissement peut supprimer des éléments.

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

Syntaxe

a.length
 a[i]
 a[i] = value
 a.length = newLength
 delete a[i]
 Object.hasOwn(a, i)
 a.at(-1)

a.length est une propriété de données propre à une instance d’Array, et non une méthode ni une propriété statique. Les indices commencent à 0. Quand la longueur est non nulle, a.length - 1 désigne la dernière position, qui peut être vide. La longueur va de 0 à 2 ** 32 - 1 ; le plus grand indice de tableau est 2 ** 32 - 2.

a[1] et a["1"] désignent la même clé de propriété. Les clés utilisées par a["01"], a[-1] et a[2 ** 32 - 1] ne sont pas des indices de tableau : y écrire ne change pas la longueur. En revanche, a.at(-1) lit la dernière position par rapport à la longueur et renvoie undefined si celle-ci vaut zéro.

Si une écriture crée un élément propre à l’indice i >= a.length, la longueur passe à i + 1 et les positions sautées restent vides. Un trou n’est pas un élément propre valant undefined : la lecture entre crochets peut trouver une propriété héritée et renvoie undefined si aucune propriété ne correspond. Object.hasOwn(a, i) teste la présence d’une propriété propre ; i in a examine aussi la chaîne de prototypes.

Augmenter length ne crée aucun élément. La réduire supprime les éléments propres dont l’indice est supérieur ou égal à la nouvelle longueur, en commençant par le plus grand indice. Rallonger le tableau ne les rétablit pas. Un delete a[i] réussi ne raccourcit pas le tableau.

Affecter un nombre hors plage ou non entier à une propriété length accessible en écriture déclenche RangeError. Un élément non configurable peut bloquer le raccourcissement : la longueur devient son indice plus un et les suppressions déjà effectuées ne sont pas annulées. En mode strict, cet échec d’affectation déclenche TypeError ; hors mode strict, il peut rester silencieux.

Exemples

{
  const a = ["A", undefined];
  a[3] = "D";
  console.log(`${a.length} ${a[1]} ${a[2]}`);
  console.log(`${Object.hasOwn(a, 1)} ${Object.hasOwn(a, 2)}`);

  a[-1] = "label";
  console.log(`${a[-1]} ${a.at(-1)} ${a.length}`);

  a.length = 2;
  a.length = 4;
  console.log(`${a.length} ${Object.hasOwn(a, 3)} ${a[-1]}`);
}

Résultat

4 undefined undefined
true false
label D 4
4 false label

Les lectures aux indices `1` et `2` donnent `undefined`, mais seul `1` correspond à un élément propre. La clé `-1` contient `label`, tandis que `a.at(-1)` donne `D`. Le raccourcissement supprime `D` ; le rallongement ne le rétablit pas et ne touche pas à la propriété `-1`.

Leçons associées

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

Sources