.unshift()

Published Jun 21, 2021Updated Jun 12, 2023
Contribute to Docs

Adds one or more elements to beginning of array and returns new length.

Syntax

array.unshift(item1, item2, ...);

Examples

To add the element 'Monday' to the daysOfWeek array:

const daysOfWeek = [
'Tuesday',
'Wednesday',
'Thursday',
'Friday',
'Saturday',
'Sunday',
];
daysOfWeek.unshift('Monday');
console.log(daysOfWeek);
// Output: ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']

To add elements 1 and 2 to the countToTen array:

const countToTen = [3, 4, 5, 6, 7, 8, 9, 10];
countToTen.unshift(1, 2);
console.log(countToTen);
// Output: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

Codebyte Example

The code below adds Lemon and Pineapple to the beginning of the array fruits with the help of the .unshift() method.

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...

All contributors

Looking to contribute?

Learn JavaScript on Codecademy