La méthode unshift()
ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.
var a = [1, 2, 3]; a.unshift(4, 5); console.log(a); // [4, 5, 1, 2, 3]
Syntaxe
arr.unshift([élém1[, ...[, élémN]]])
Paramètres
élémN
- 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 | État | Commentaires |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | 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 2015 (6th Edition, ECMA-262) La définition de 'Array.prototype.unshift' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Array.prototype.unshift' dans cette spécification. |
Projet |
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) |