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.

See Also

concat Method (Array)
pop Method (Array)