Array.
Ajoute des éléments à la fin du tableau et renvoie sa nouvelle longueur.
- Renvoie
- La nouvelle longueur du tableau.
- Modifie l’original
- Oui
Exemple
#const cart = ['Cours HTML']
const newLength = cart.push('Cours CSS', 'Cours JS')
console.log(newLength)
console.log(cart)Définition et utilisation
#La méthode push() ajoute un ou plusieurs éléments à la fin du tableau. Elle modifie le tableau d’origine et renvoie sa nouvelle longueur, et non le tableau lui-même.
C’est le moyen le plus courant d’ajouter des données : un nouveau message dans un chat, une tâche dans une liste, un résultat dans un historique.
Dans un code basé sur l’immutabilité des données (par exemple l’état React), on crée un nouveau tableau au lieu d’utiliser push() : [...items, newItem].
Syntaxe
#array.push(element1, element2, …)Paramètres
#element1…elementN
valeurs quelconques
Éléments à ajouter à la fin.
Plus d’exemples
#const cart = ['Cours HTML']
const updated = [...cart, 'Cours Python']
console.log(cart)
console.log(updated)Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- N’affectez pas le résultat de
push()au tableau :list = list.push(x)transformerait le tableau en nombre. - Pour combiner deux tableaux, utilisez
concat()ou la syntaxe..., paspush()avec un tableau (il serait ajouté comme un seul élément).
Entrées associées
#- Array.prototype.pop()Supprime le dernier élément du tableau et le renvoie.
- Array.prototype.unshift()Ajoute des éléments au début du tableau et renvoie sa nouvelle longueur.
- Array.prototype.concat()Combine des tableaux et des valeurs en un nouveau tableau.
- Spread (...)La syntaxe spread décompose un tableau, une chaîne ou un objet en éléments individuels : pour copier, fusionner et passer des arguments.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.