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

CKTIS / JavaScript

Longueur et indexation des tableaux en JavaScript

`length` fixe la borne des indices d’un tableau sans compter ses éléments. Une écriture peut déplacer cette borne, et un emplacement vide se distingue d’une valeur `undefined`.

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

Syntaxe

a.length; a[i]; a[i] = value; a.length = n; delete a[i]; Object.hasOwn(a, i); a.at(i);

Les indices d’un tableau commencent à zéro. a.length est une propriété propre, modifiable par défaut mais non configurable. Sa valeur est un entier de 0 à 2 ** 32 - 1. Elle donne la borne supérieure exclue des indices des éléments propres, pas leur nombre. En revanche, Array.length indique le nombre de paramètres attendus par la fonction constructeur, pas la longueur d’un tableau.

Les crochets accèdent à une propriété : a[1] et a["1"] utilisent la même clé. Les indices sont les écritures décimales canoniques des entiers de 0 à 2 ** 32 - 2. Les clés "01", "-1" et "4294967295" ne sont pas des indices et n’affectent pas la longueur. a[-1] recherche la propriété "-1" ; a.at(-1) lit la dernière position d’un tableau non vide. Si l’indice calculé est hors limites, at() renvoie undefined sans rechercher cette propriété.

Créer un élément propre à un indice i >= a.length porte la longueur à i + 1. Les positions sautées restent vides. Un emplacement vide n’a pas de propriété propre ; sa lecture donne undefined sauf si une valeur est héritée. Object.hasOwn(a, i) le distingue d’un élément propre dont la valeur est undefined. Si delete a[i] réussit, il supprime l’élément sans raccourcir le tableau.

Augmenter length ajoute des emplacements vides ; la réduire supprime les éléments propres à partir de la nouvelle borne. Si length est modifiable, lui affecter une valeur de type Number qui n’est pas entière ou qui est hors de la plage autorisée déclenche RangeError. Lui affecter une valeur de type BigInt déclenche en revanche TypeError lors de la conversion, avant la vérification des limites. Un élément non configurable peut bloquer le raccourcissement : des éléments d’indice supérieur peuvent déjà avoir été supprimés, et la longueur s’arrête à l’indice bloquant plus un. En mode strict, cet échec d’affectation déclenche TypeError.

Exemples

{
  const a = ["A"];
  a[3] = "D";
  a[2] = undefined;
  a[-1] = "tag";

  console.log(`length: ${a.length}`);
  console.log(`1: ${a[1]}, own: ${Object.hasOwn(a, 1)}`);
  console.log(`2: ${a[2]}, own: ${Object.hasOwn(a, 2)}`);
  console.log(`[-1]: ${a[-1]}, at(-1): ${a.at(-1)}`);

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

Résultat

length: 4
1: undefined, own: false
2: undefined, own: true
[-1]: tag, at(-1): D
length: 4, own 3: false, [-1]: tag

La lecture aux indices `1` et `2` donne `undefined`, mais seul `2` est un élément propre. Rallonger le tableau ne restaure pas l’élément `3` ; la propriété `"-1"` reste présente.

Leçons associées

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

Sources