unshift Method (Windows Scripting - JScript)

Inserts new elements at the start of an array.

Syntax

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

Arguments

• arrayObj
  Required. An Array object.

• item1, item2,. . ., itemN
  Optional. Elements to insert at the start of the Array.

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.

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

Requirements

Version 5.5

Applies To: Array Object (Windows Scripting - JScript)

Change History

See Also

shift Method (Windows Scripting - JScript)