mozilla
Vos résultats de recherche

    Array.length

    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.

    Attributs de Array.length
    Écrivable Oui
    Énumérable Non
    Configurable Non

    Syntaxe

    tableau.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 (232).

    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 nombre de valeurs définies dans le tableau. Voir aussi la relation entre longueur et propriétés numériques.

    Exemples

    Parcourir un tableau

    Dans l'exemple suivant, on itère sur le tableau nombres en utilisant la propriété length afin de connaître son nombre d'élément. La valeur de chaque élément est ensuite multipliée par deux :

    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];
    

    Tronquer 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
    }

    Specifications

    Spécification Statut Commentaires
    Première édition d'ECMAScript. Standard Définition initiale.
    ECMAScript 5.1 (ECMA-262)
    La définition de 'Array.length' dans cette spécification.
    Standard  
    ECMAScript 6 (ECMA-262)
    La définition de 'Array.length' dans cette spécification.
    En cours de validation comme recommandation  

    Compatibilité des navigateurs

    Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
    Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

    Voir aussi

    Étiquettes et contributeurs liés au document

    Contributors to this page: teoli, SphinxKnight, greygjhart
    Dernière mise à jour par : SphinxKnight,
    Masquer la barre latérale