JavaScript unshift() Method
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 »
|
JavaScript Array Object
 |
W3Schools' Online Certification Program
The perfect solution for professionals who need to balance work, family, and career building.
More than 4000 certificates already issued!
|
The HTML Certificate documents your knowledge of HTML, XHTML, and CSS.
The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.
The XML Certificate documents your knowledge of XML, XML DOM and XSLT.
The ASP Certificate documents your knowledge of ASP, SQL, and ADO.
The PHP Certificate documents your knowledge of PHP and SQL (MySQL).
|