Definition and Usage The unshift() method adds one or more elements to the beginning of an array and returns the new length. Syntax a...
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
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 |
