unshift Method (Array) (JavaScript)


Inserts new elements at the start of an array.

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


Required. An Array object.

item1, item2,. . ., itemN

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

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.


The following example illustrates the use of the unshift method.

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

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


Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards, Internet Explorer 11 standards. Also supported Store apps (Windows 8 and Windows Phone 8.1). See Version Information.