unshift

Summary

Inserts new elements at the start of an array.

Syntax

unshift([ item1 [, item2 [, . . . [, itemN]]]])

item1, item2,. . ., itemN

Optional. Elements to insert at the start of the Array.

Examples

The following example illustrates the use of the unshift method.

var ar = new Array();
 ar.unshift(10, 11);
 ar.unshift(12, 13, 14);
 document.write(ar.toString());

 // Output: 12,13,14,10,11

Remarks

The unshift method inserts elements into the start of an array, so they appear in the same order in which they appear in the argument list.

See also

Specification

[15.4.4.13 Array.prototype.unshift ( [ item1 [ , item2 , … ] ] )] ECMAScript® Language Specification Standard ECMA-262 5.1 Edition / June 2011

Attributions

• Microsoft Developer Network: Article