CKTIS / JavaScript
`length` : la propriété modifiable d’un tableau
Lisez `arr.length` pour connaître la longueur du tableau. Affectez-lui une valeur pour raccourcir ce même tableau ou l’allonger sans créer d’éléments.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
arr.length
arr.length = newLengtharr.length est une propriété de données propre à une instance de Array, et non la propriété length du constructeur Array. Elle est initialement accessible en écriture, mais ni énumérable ni configurable. Sa valeur dépasse tout indice propre au tableau et peut dépasser le nombre d’éléments présents.
Réduire length supprime les éléments propres dont l’indice est supérieur ou égal à la nouvelle longueur. arr.length = 0 vide un tableau ordinaire sur place : le changement est visible depuis toutes les références au même tableau. Augmenter la longueur laisse des emplacements vides, et non des éléments valant undefined, et ne rétablit pas les éléments supprimés. Créer un élément à un indice valide i supérieur ou égal à la longueur courante fait passer celle-ci à i + 1.
La longueur est un entier de type Number compris entre 0 et 2 ** 32 - 1 inclus. Quand la propriété est accessible en écriture, la valeur affectée est convertie : "3" est par exemple accepté et devient 3, tandis que 2.5, -1 et 2 ** 32 déclenchent une RangeError. La conversion d’un Symbol ou d’un BigInt déclenche une TypeError à la place.
Si le raccourcissement rencontre un élément non configurable, il s’arrête à cet indice. La longueur prend la valeur de cet indice plus un, et les éléments d’indice supérieur déjà supprimés ne sont pas rétablis. writable: false permet aussi de verrouiller définitivement length en écriture. Cela empêche les affectations à length et les ajouts qui allongeraient le tableau, mais pas toute modification des éléments. Dans les deux cas, une affectation qui échoue déclenche une TypeError en mode strict ; hors de ce mode, elle ne lève pas d’exception.
Exemples
(() => {
"use strict";
const arr = ["a", "b", "c"];
const alias = arr;
arr.length = 1;
console.log(`${alias.length}: ${alias.join(",")}`);
arr.length = 3;
arr[2] = undefined;
console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);
arr[4] = "e";
console.log(`${arr.length}: ${arr[4]}`);
try {
arr.length = 2.5;
} catch (error) {
console.log(`${error.name}: ${arr.length}`);
}
})();Résultat
1: a 3: false, true 5: e RangeError: 5
`alias` permet d’observer le raccourcissement du même tableau. Après l’allongement, `Object.hasOwn` distingue l’emplacement vide à l’indice `1` de la valeur `undefined` affectée explicitement à l’indice `2`. L’écriture à l’indice `4` porte la longueur à `5` ; le rejet de `2.5` ne la modifie pas.
Leçons associées
- JavaScript · Leçon 20 · Avancé · Version : 4