JavaScript Array unshift() Method

JavaScript Array unshift() Method is used to add one or more elements to the beginning of the given array. This function increases the length of the existing array by the number of elements added to the array.

Syntax:

array.unshift(element1, element2, ..., elementX);

Parameters:

• element: This parameter element is to be added at the beginning of the array.

Return value:

This function returns the new length of the array after inserting the arguments at the beginning of the array. 

Example 1: Below is an example of the Array unshift() method.

function func() {

    // Original array
    let array = ["GFG", "Geeks", "for", "Geeks"];

    // Checking for condition in array
    let value = array.unshift("GeeksforGeeks");
    console.log(value);
    console.log(array);
}
func();

5
[ 'GeeksforGeeks', 'GFG', 'Geeks', 'for', 'Geeks' ]

Example 2: In this example, the function unshift() adds 28 and 65 to the front of the array.

function func() {
    let arr = [23, 76, 19, 94];
    
    // Adding elements to the front of the array
    console.log(arr.unshift(28, 65));
    console.log(arr);
}
func();

6
[ 28, 65, 23, 76, 19, 94 ]

Example 3: In this example, the unshift() method tries to add the element of the array, but the array is empty therefore it adds the value in the empty array.

function func() {
    let arr = [];
    console.log(arr.unshift(1));
}
func();

1

We have a complete list of Javascript Array methods, to check those please go through this Javascript Array Complete reference article.

Supported Browsers:

• Google Chrome 1
• Edge 12
• Firefox 1
• Opera 4
• Safari 1