mozilla
Vos résultats de recherche

    Array.prototype.shift()

    Résumé

    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.

    Syntaxe

    arr.shift()

    Description

    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.

    Exemples

    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 mesPoissons = ["ange", "clown", "mandarin", "chirurgien"];
    
    console.log("mesPoissons avant : " + mesPoissons);
    
    var premierÉlément = mesPoissons.shift();
    
    console.log("mesPoissons après : " + mesPoissons);
    console.log("Cet élément a été enlevé : " + premierÉlément);
    

    Ce qui nous donne ce résultat :

    mesPoissons avant : ange,clown,mandarin,chirurgien
    mesPoissons après : clown,mandarin,chirurgien
    Cet élément a été enlevé : ange
    

    Spécifications

    Spécification Statut Commentaires
    Troisième édition d'ECMAScript Standard Définition initiale. Implémentée avec JavaScript 1.2.
    ECMAScript 5.1 (ECMA-262)
    La définition de 'Array.prototype.shift' dans cette spécification.
    Standard  
    ECMAScript 6 (ECMA-262)
    La définition de 'Array.prototype.shift' dans cette spécification.
    Draft  

    Compatibilité des navigateurs

    Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Support simple 1.0 1.0 (1.7 ou moins) 5.5 (Oui) (Oui)
    Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

    Voir aussi

    Étiquettes et contributeurs liés au document

    Contributors to this page: soyuka, gsanson, Pihemde, SphinxKnight, teoli
    Dernière mise à jour par : SphinxKnight,