Array.prototype.shift()

Résumé

La méthode shift() retire le premier élément d'un tableau et le retourne. Cette méthode modifie la longueur du tableau.

Syntaxe

arr.shift()

Description

La méthode shift  enlève l'élément à l'index zéro et décrémente l'index des propriétés qui suivent avant de retourner l'élément supprimé. Si la propriété length a pour valeur 0, undefined est retourné.

Cette méthode est volontairement générique et peut être appelée or appliquée sur des objets similaires aux 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.

Exemples

Exemple : Supprimer un élément d'un tableau

Le code suivant affiche le tableau  myFish avant et après avoir enlevé le premier élément. Il affiche aussi l'élément supprimé : 

var myFish = ["angel", "clown", "mandarin", "surgeon"];

console.log("myFish avant : " + myFish);

var shifted = myFish.shift();

console.log("myFish après : " + myFish);
console.log("Cet élément a été enlevé : " + shifted);

Ce qui nous donne ce résultat :

myFish avant : angel,clown,mandarin,surgeon
myFish après : clown,mandarin,surgeon
Cet élément a été enlevé : angel

Spécifications

Compatibilité des navigateurs

Voir aussi

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.unshift()