mozilla
Vos résultats de recherche

    Array.prototype.unshift()

    Résumé

    La méthode unshift() ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.

    Syntaxe

    arr.unshift([élém1[, ...[, élémN]]])

    Paramètres

    élém N
    Les éléments qu'on souhaite ajouter en début de tableau.

    Valeur de retour

    La nouvelle valeur de la propriété length du tableau sur lequel a été appelée la méthode.

    Description

    La méthode unshift() insère les valeurs renseignées au début d'un objet ressemblant à un tableau.

    unshift() est volontairement générique ; cette méthode peut être appelée ou appliquée sur des objets ressemblant à des tableaux. Les objets qui ne contiennent pas une propriété length reflètant la fin d'une série de propriétés indexées numériquement pourront ne pas avoir un comportement cohérent avec cette méthode.

    Exemples

    var arr = [1, 2];
    
    arr.unshift(0); // renvoie 3, la nouvelle longueur du tableau
    // arr est [0, 1, 2]
    
    arr.unshift(-2, -1); // = 5
    // arr est [-2, -1, 0, 1, 2]
    
    arr.unshift( [-3] );
    // arr est [[-3], -2, -1, 0, 1, 2]

    Spécifications

    Spécification Statut Commentaires
    Troisième édition ECMAScript Standard Définition initiale. Implémentée avec JavaScript 1.2.
    ECMAScript 5.1 (ECMA-262)
    La définition de 'Array.prototype.unshift' dans cette spécification.
    Standard  
    ECMAScript 6 (ECMA-262)
    La définition de 'Array.prototype.unshift' 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: SphinxKnight, BenoitL, teoli, tregagnon, Jeremie
    Dernière mise à jour par : SphinxKnight,