★ wanayoo — archive 1999 https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array/pushNouvelle recherche | Portail wanayoo
Vos résultats de recherche

    Array.prototype.push()

    Résumé

    La méthode push() ajoute un ou plusieurs éléments à la fin d'un tableau et retourne la nouvelle taille du tableau.

    Syntaxe

    arr.push(element1, ..., elementN)

    Paramètres

    element1, ..., elementN
    Les éléments à ajouter à la fin du tableau.

    Retourne

    La nouvelle valeur de la propriété length de l'objet sur lequel la méthode a été appelée.

    Description

    La méthode push ajoute des valeurs à un tableau.

    push est une appellation volontairement générique. Cette méthode peut ainsi être appelée ou appliquée sur des objets similaires aux tableaux.

    La méthode push se base sur la propriété length pour déterminer à partir de quel index les valeurs données doivent être insérées. Si la propriété length ne peut pas être convertie en nombre, l'index utilisé est 0. Si la propriété length n'est pas définie, elle est alors créée.

    Le seul objet natif ressemblant à un tableau est l'objet String, mais la méthode push y est difficilement applicable, car String est immuable.

    Exemples

    Exemple: Ajouter des éléments à un tableau

    Le code suivant crée un tableau sports contenant à sa création deux éléments, auxquels sont ajoutés deux nouveaux éléments. La variable total contient la nouvelle taille du tableau.

    var sports = ["soccer", "baseball"];
    var total = sports.push("football", "swimming");
    
    console.log(sports); // ["soccer", "baseball", "football", "swimming"]
    console.log(total);  // 4
    

    Spécifications

    Specification Status Comment
    ECMAScript 3rd Edition Standard Initial definition. Implemented in JavaScript 1.2
    ECMAScript Language Specification 5.1th Edition (ECMA-262) Standard  
    ECMAScript Language Specification 6th Edition (ECMA-262) Draft  

    Compatibilité des navigateurs

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support 1.0 1.0 (1.7 ou moins) 5.5 (Oui) (Oui)
    Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

    A voir également

    Étiquettes et contributeurs liés au document

    Contributeurs ayant participé à cette page : gsanson, teoli
    Dernière mise à jour par : teoli,