w3schools
  
HOME HTML CSS XML JAVASCRIPT ASP PHP SQL MORE...   References Examples Forum About

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



W3Schools Certification

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).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Top 10 Web Hosting
UK Reseller Hosting
Web Hosting
FREE Web Hosting
Top Web Hosting
Windows Hosting
WEB BUILDING
XML Editor – Free Trial!
FREE Flash Website
FREE Web Templates
FLIGHT TICKETS
Find the cheapest flight
to any destination now!
EDUCATION
US Web Design Schools
HTML Certification
JavaScript Certification
XML Certification
PHP Certification
ASP Certification
STATISTICS
Browser Statistics
Browser OS
Browser Display