Array.length

Sommaire

La propriété length (longueur) représente un entier non-signé de 32 bits qui spécifie le nombre d'éléments présents dans un tableau.

Syntaxe

arr.length

Description

La valeur de la propriété length est un entier de signe positif dont la valeur est inférieure à 2 à la puissance 32 (2³²).

Vous pouvez modifier la propriété length d'un tableau à loisir pour le tronquer. Quand vous étendez un tableau en modifiant la valeur de sa propriété length, le nombre d'éléments réellement présents dans ce tableau n'augmente pas : par exemple, si vous affectez la valeur 3 à la propriété length d'un tableau alors qu'elle vaut 2, le tableau contiendra toujours seulement 2 éléments.  De ce fait, la propriété length d'un tableau ne renseigne en rien sur le nombe de valeurs définies dans un tableau. Voir aussi Relation entre longueur et propriétés numériques.

Exemples

Exemple: Itération sur un tableau

Dans l'exemple suivant, l'on itère sur le tableau nombres en regardant la propriété length pour connaître son nombre d'élément. La valeur de chaque élément est ensuite doublée.

var nombres = [1,2,3,4,5];

for (var i = 0; i < nombres.length; i++) {
  nombres[i] *= 2;
}
// nombres vaut maintenant [2,4,6,8,10];

Exemple: Raccourcir un tableau

L'exemple suivant raccourcit le tableau etatsUS à 50 si sa longueur actuelle est supérieure à 50.

if (etatsUS.length > 50) {
   etatsUS.length=50
}

Spécifications

Compatibilité entre navigateurs

Voir aussi

• Array