From http://www.w3schools.com (Copyright Refsnes Data)

JavaScript unshift() Method

Array Object Reference JavaScript Array Object

Definition and Usage

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

Syntax

arrayObject.unshift(newelement1,newelement2,....,newelementX)

Parameter Description
newelement1 Required. The first element to add to the array
newelement2 Optional. The second element to add to the array
newelementX Optional. Several elements may be added

Tips and Notes

Note: This method changes the length of the array.

Note: The unshift() method does not work properly in Internet Explorer!

Tip: To add one or more elements to the end of an array, use the push() method.

Example

Example

In this example we will create an array, add an element to the beginning of the array and then return the new length:

<script type="text/javascript">

var arr = new Array();
arr[0] = "Jani";
arr[1] = "Hege";
arr[2] = "Stale";

document.write(arr + "<br />");
document.write(arr.unshift("Kai Jim") + "<br />");
document.write(arr);

</script>

The output of the code above will be:

Jani,Hege,Stale
4
Kai Jim,Jani,Hege,Stale

Try it yourself »

Array Object Reference JavaScript Array Object

From http://www.w3schools.com (Copyright Refsnes Data)