W3Schools.com

JavaScript unshift() Method

Array Object Reference 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

Internet Explorer Firefox Opera Google Chrome Safari

The unshift() method is supported in all major browsers.

Note: The unshift() method is not supported in Internet Explorer 8 and earlier.


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 »


Array Object Reference JavaScript Array Object
WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
XML Editor - Free Trial!
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE