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) |