Référence de JavaScript 1.5 Core:Objets globaux:Array:length

Un article de MDC.

Sommaire 1 Résumé 2 Description 3 Exemples 3.1 Exemple : parcours d'un tableau 3.2 Exemple : troncature d'un tableau

[modifier] Résumé

Un entier non signé sur 32 bits indiquant le nombre d'éléments dans le tableau.

Propriété de Array
Implémentation :	JavaScript 1.1, NES 2.0 JavaScript 1.3 : length est un entier non signé sur 32 bits avec une valeur inférieure à 232.
Version ECMA :	ECMA-262

[modifier] Description

La valeur de la propriété length est un entier positif dont la valeur est inférieure à 2³² (4 294 967 296).

On peut modifier la propriété length à tout moment pour tronquer un tableau. Par contre, quand on l'agrandit de cette manière, le nombre réel d'éléments n'augmente pas ; par exemple, si l'on positionne length à 3 alors qu'il valait 2, le tableau ne contient toujours que 2 éléments.

[modifier] Exemples

[modifier] Exemple : parcours d'un tableau

Dans l'exemple qui suit, on parcourt le tableau nombres en consultant sa propriété length pour connaitre son nombre d'éléments. Chacune des valeurs est ensuite doublée.

var nombres = [1,2,3,4,5];
for (var i = 0; i < nombres.length; i++) {
  nombres[i] *= 2;
}
// nombres est à présent [2,4,6,8,10];

[modifier] Exemple : troncature d'un tableau

L'exemple suivant réduit le tableau etatsUS à une longueur de 50 si sa longueur actuelle dépasse cette valeur.

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