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(element1, ..., elementN) 

Paramètres

element1, ..., element N

Les éléments à ajouter en début de tableau.

Renvoie

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 called ou applied sur des objets ressemblant à des tableaux. Les objets qui ne contiennent pas une propriété length reflètant la fin d'une série consécutive numérique des propriétés ne peut pas se comporter de manière cohérente.

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

Compatibilité des navigateurs

Voir également

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