CKTIS / JavaScript
Longueur d’un tableau : Array.length
La propriété length indique la longueur d’un tableau, mais pas nécessairement le nombre d’éléments existants. Lui affecter une valeur peut supprimer des éléments ou augmenter la longueur sans remplir les nouvelles positions.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
array.length
array.length = newLengthArray.length désigne ici la propriété length d’une instance de tableau, lue sous la forme array.length, et non la propriété du constructeur Array. C’est une propriété, pas une méthode. Sa valeur est un entier compris entre 0 et 2 ** 32 - 1 inclus.
La longueur ne compte pas les éléments existants : un tableau peut contenir des emplacements vides. Si une affectation crée un élément à un indice du tableau supérieur ou égal à la longueur actuelle, length prend la valeur de cet indice plus un. Si length a été rendue non inscriptible, une telle affectation n’ajoute pas l’élément et n’allonge pas le tableau : en mode strict, elle déclenche une TypeError ; sinon, elle échoue silencieusement. delete array[i] supprime l’élément s’il s’agit d’une propriété propre et configurable du tableau, mais ne réduit pas la longueur. Si la propriété propre à cet indice n’est pas configurable, elle reste en place : delete renvoie false hors du mode strict et déclenche une TypeError en mode strict.
Affecter une longueur plus petite supprime les éléments propres dont les indices sont supérieurs ou égaux à la nouvelle longueur. Augmenter la longueur ne crée pas d’éléments contenant undefined ; cela laisse des emplacements vides. Dans l’exemple, l’écriture à l’indice 4 fixe la longueur à 5, puis la réduction à 2 supprime cet élément.
Si une affectation à array.length atteint l’étape de validation de la nouvelle longueur, un nombre négatif, une fraction non entière, NaN, Infinity ou 2 ** 32 provoque une RangeError. Si length n’est pas inscriptible, l’affectation est rejetée sans validation de la nouvelle longueur : elle déclenche une TypeError en mode strict et échoue silencieusement sinon. Initialement, length est inscriptible, non énumérable et non configurable. Un élément non configurable peut empêcher la troncature : la longueur s’arrête à son indice plus un. En mode strict, cette affectation déclenche une TypeError, et des éléments d’indices supérieurs peuvent déjà avoir été supprimés.
Exemples
const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));Résultat
5 false [10,20] 4 false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.