JavaScript - Array unshift() Method

Description

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

Syntax

Its syntax is as follows −

array.unshift( element1, ..., elementN );

Parameter Details

element1, ..., elementN − The elements to add to the front of the array.

Return Value

Returns the length of the new array. It returns undefined in IE browser.

Example

Try the following example.

Live Demo

<html>
   <head>
      <title>JavaScript Array unshift Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         var arr = new Array("orange", "mango", "banana", "sugar");         
         var length = arr.unshift("water");
         document.write("Returned array is : " + arr );
         document.write("<br /> Length of the array is : " + length );
      </script>      
   </body>
</html>

Output

Returned array is : water,orange,mango,banana,sugar
Length of the array is : 5

javascript_arrays_object.htm