Array.prototype.unshift()
La méthode unshift()
ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
arr.unshift([élém1[, ...[, élémN]]])
Paramètres
élémN
- Les éléments que l'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.
Attention, lorsqu'on utilise unshift()
avec plusieurs arguments, ceux-ci sont insérés au début du tableau dans l'ordre selon lequel ils sont passés en arguments. Aussi, on n'obtiendra pas le même résultat en appelant unshift()
n fois avec 1 arguments ou en appelant unshift()
avec n arguments.
let arr = [4, 5, 6];
arr.unshift(1, 2, 3);
console.table(arr);
// [1, 2, 3, 4, 5, 6]
let arr2 = [4, 5, 6];
arr2.unshift(1);
arr2.unshift(2);
arr2.unshift(3);
console.table(arr2);
// [3, 2, 1, 4, 5, 6]
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] ); // 6
// arr est [[-3], -2, -1, 0, 1, 2]
arr.unshift([-7, -6], [-5]); // 8
// arr est [[-7, -6], [-5], [-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 (ECMA-262) La définition de 'Array.prototype.unshift' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser