This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

push

Summary

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

Syntax

push([ item1  [ item2 [. . . [ itemN ]]]])
item, item2,. . ., itemN
Optional. New elements of the Array.

Examples

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

Remarks

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.

See also

Specification

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

Attributions

  • Microsoft Developer Network: Article