Baseline Widely available
La méthode shift()
permet de retirer le premier élément d'un tableau et de renvoyer cet élément. Cette méthode modifie la longueur du tableau.
const array1 = [1, 2, 3];
const firstElement = array1.shift();
console.log(array1);
// Expected output: Array [2, 3]
console.log(firstElement);
// Expected output: 1
Syntaxe Valeur de retour
L'élément retiré du tableau ou undefined
si le tableau est vide.
La méthode shift
retire l'élément situé à l'index zéro et décrémente l'index des éléments suivant avant de retourner l'élément supprimé. Si la propriété length
vaut 0, undefined
est retourné.
Cette méthode est générique et peut être appelée ou appliquée sur des objets similaires à des tableaux.
Cette méthode n'est pas exploitable pour les objets dont la propriété length
ne reflète pas la taille du contenu, ou pour lesquels la propriété length
n'est pas définie.
Note : La méthode Array.prototype.pop()
possède un comportement similaire mais retire le dernier élément du tableau (et non le premier).
Le code suivant affiche le tableau mesPoissons
avant et après avoir enlevé le premier élément. Il affiche aussi l'élément supprimé :
var mesPoissons = ["ange", "clown", "mandarin", "chirurgien"];
console.log("mesPoissons avant : " + JSON.stringify(mesPoissons));
// mesPoissons avant : ["ange","clown","mandarin","chirurgien"]
var premierÃlément = mesPoissons.shift();
console.log("mesPoissons après :", mesPoissons);
// mesPoissons après : ["clown", "mandarin", "chirurgien"]
console.log("Cet élément a été enlevé :", premierÃlément);
// "Cet élément a été enlevé : ange"
Utiliser shift()
dans une boucle while
La méthode shift()
peut être utilisée dans une boucle while
. Dans l'exemple suivant, chaque itération de la boucle retire un élément du tableau et l'affiche dans la console, jusqu'à ce que ce dernier soit vide.
var noms = ["André", "Ãdouard", "Paul", "Christophe", "Jean"];
while ((i = noms.shift()) !== undefined) {
console.log(i);
}
// André, Ãdouard, Paul, Christophe, Jean
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