push Method (Array) (JavaScript)

Appends new elements to an array, and returns the new length of the array.

arrayObj.push([item1 [item2 [. . . [itemN ]]]])


Required. An Array object.

item, item2,. . ., itemN

Optional. New elements of the Array.

The push and pop methods allow you to simulate a last in, first out stack.

The push method appends elements in the order in which they appear. If one of the arguments is an array, it is added as a single element. Use the concat method to join the elements from two or more arrays.

The following example illustrates the use of the push method.

var number;
var my_array = new Array();

my_array.push (5, 6, 7);
my_array.push (8, 9);

number = my_array.pop();
while (number != undefined)
   document.write (number + " ");
   number = my_array.pop();

// Output:
// 9 8 7 6 5

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.

© 2014 Microsoft