Array.prototype.unshift()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Exemple interactif

const array1 = [1, 2, 3];console.log(array1.unshift(4, 5));// Expected output: 5console.log(array1);// Expected output: Array [4, 5, 1, 2, 3]

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éthodeunshift() 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 êtreappelée ouappliqué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 utiliseunshift() 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 appelantunshift()n fois avec 1 arguments ou en appelantunshift() avecn 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]