Array.
Ajoute des éléments au début du tableau et renvoie sa nouvelle longueur.
- Renvoie
- La nouvelle longueur du tableau.
- Modifie l’original
- Oui
Exemple
#const notifications = ['Nouvelle tâche']
notifications.unshift('Badge obtenu', 'Série de 7 jours')
console.log(notifications)Définition et utilisation
#La méthode unshift() insère un ou plusieurs éléments au début du tableau, en décalant les éléments existants. Elle renvoie la nouvelle longueur du tableau.
Les éléments passés en un seul appel gardent leur ordre : unshift("a", "b") donnera un tableau commençant par "a", puis "b".
La méthode modifie l’original. La version sans mutation est [newItem, ...items], souvent utilisée dans l’état d’une application, par exemple pour ajouter la notification la plus récente en haut d’une liste.
Syntaxe
#array.unshift(element1, element2, …)Paramètres
#element1…elementN
valeurs quelconques
Éléments à insérer au début.
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
#- Version sans mutation :
[newItem, ...items]. - Sur de très grands tableaux, un
unshift()fréquent est lent, car il décale tous les éléments.
Entrées associées
#- Array.prototype.push()Ajoute des éléments à la fin du tableau et renvoie sa nouvelle longueur.
- Array.prototype.shift()Supprime le premier élément du tableau et le renvoie.
- 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.