JavaScript unshift() Method
 JavaScript Array Object
Definition and Usage
The unshift() method adds new elements to the beginning of an array, and returns the new length.
Note: This method changes the length of an array!
Syntax
| array.unshift(element1,element2, ..., elementX) |
| Parameter |
Description |
| element1,element2, ..., elementX |
Required. The element(s) to add to the beginning of the array |
Browser Support
The unshift() method is supported in all major browsers, except Internet
Explorer.
Tips and Notes
Note: The unshift() method returns undefined in Internet Explorer!
Tip: To add new elements to the end of an array, use the
push() method.
Example
Example
Add new elements to the beginning of an array, and return the new length:
<script type="text/javascript">
var fruits = ["Banana", "Orange", "Apple", "Mango"];
document.write(fruits.unshift("Kiwi") + "<br />");
document.write(fruits.unshift("Lemon","Pineapple") + "<br />");
document.write(fruits);
</script>
|
The output of the code above will be:
5
7
Lemon,Pineapple,Kiwi,Banana,Orange,Apple,Mango |
Try it yourself »
|
JavaScript Array Object
|
