Baseline Widely available
La méthode push()
ajoute un ou plusieurs éléments à la fin d'un tableau et retourne la nouvelle taille du tableau.
const animals = ["pigs", "goats", "sheep"];
const count = animals.push("cows");
console.log(count);
// Expected output: 4
console.log(animals);
// Expected output: Array ["pigs", "goats", "sheep", "cows"]
animals.push("chickens", "cats", "dogs");
console.log(animals);
// Expected output: Array ["pigs", "goats", "sheep", "cows", "chickens", "cats", "dogs"]
Syntaxe
arr.push(élément1, ..., élémentN)
Paramètres
élément1, ..., élémentN
Les éléments à ajouter à la fin du tableau.
La nouvelle valeur de la propriété length
de l'objet sur lequel la méthode a été appelée.
La méthode push
permet d'ajouter des valeurs à un tableau.
push
est une méthode générique. Cette méthode peut ainsi être utilisée avec les méthodes Function.call()
ou Function.apply()
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.
Bien que push
soit une méthode générique, elle ne peut pas être utilisée sur les chaînes de caractères ou sur l'objet arguments
car ils sont immuables.
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 = ["plongée", "baseball"];
var total = sports.push("football", "tennis");
console.log(sports); // ["plongée", "baseball", "football", "tennis"]
console.log(total); // 4
Fusionner deux tableaux
Dans l'exemple qui suit, on utilise la méthode Function.apply()
pour ajouter les différents éléments d'un second tableau
var legumes = ["navet", "pomme de terre"];
var autresLegumes = ["céleri", "radis"];
// On fusionne les deux tableaux
// Ãquivalent à legumes.push('céleri', 'radis');
Array.prototype.push.apply(legumes, autresLegumes);
console.log(legumes); // ['navet', 'pomme de terre', 'céleri', 'radis']
Note : Attention à ne pas utiliser cette méthode lorsque les tableaux sont très grands car une fonction n'accepte qu'un nombre limité d'arguments. Voir apply()
pour plus d'informations sur ces limites.
L'exemple qui suit utilise la syntaxe de décomposition pour ajouter les éléments d'un second tableau à la fin du premier tableau.
const legumes = ["navet", "pomme de terre"];
const autresLegumes = ["céleri", "radis"];
// On fusionne les deux tableaux
// Ãquivalent à legumes.push('céleri', 'radis');
legumes.push(...autresLegumes);
console.log(legumes); // ['navet', 'pomme de terre', 'céleri', 'radis']
Utiliser un objet comme on utiliserait un tableau
Comme nous l'avons vu auparavant, push
est une méthode générique et nous pouvons donc utiliser Array.prototype.push
sur les objets. On notera qu'il n'est pas nécessaire de stocker un ensemble d'objets. En fait, on enregistre l'ensemble dans l'objet et on utilise call
sur Array.prototype.push
:
var obj = {
length: 0,
ajoutElem: function ajoutElem(elem) {
// obj.length est automatiquement incrémenté
// quand on ajoute un élément
[].push.call(this, elem);
},
};
// Ajoutons quelques objets vides pour illustrer
// l'exemple.
obj.ajoutElem({});
obj.ajoutElem({});
console.log(obj.length);
// â 2
Spécifications Compatibilité des navigateurs Voir aussi
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4