JavaScript Array unshift()

The unshift() method adds one or more elements to the beginning of an array and returns the new length of the array.

Example

let languages = ["Java", "Python", "C"];

// add "JavaScript" at the beginning of the array languages.unshift("JavaScript");
console.log(languages); // Output: [ 'JavaScript', 'Java', 'Python', 'C' ]

unshift() Syntax

The syntax of the unshift() method is:

arr.unshift(element1, element2, ..., elementN)

Here, arr is an array.


unshift() Parameters

The unshift() method takes in an arbitrary number of elements to add to the array.


unshift() Return Value

  • Returns the new (after adding arguments to the beginning of array) length of the array upon which the method was called.

Notes:

  • This method changes the original array and its length.
  • To add elements to the end of an array, use the JavaScript Array push() method.

Example: Using unshift() method

var languages = ["JavaScript", "Python", "Java", "Lua"];

var count = languages.unshift("C++");
console.log(languages); // [ 'C++', 'JavaScript', 'Python', 'Java', 'Lua' ] console.log(count); // 5 var priceList = [12, 21, 35];
var count1 = priceList.unshift(44, 10, 1.6);
console.log(priceList); // [ 44, 10, 1.6, 12, 21, 35 ] console.log(count1); // 6

Output

[ 'C++', 'JavaScript', 'Python', 'Java', 'Lua' ]
5
[ 44, 10, 1.6, 12, 21, 35 ]
6

Recommended Readings:

Did you find this article helpful?