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