Name
Array.push( ) — append elements to an array
Availability
JavaScript 1.2; JScript 5.5; ECMAScript v3
Synopsis
array
.push(value
, ...)
Arguments
-
value, ...
One or more values to be appended to the end of
array
.
Returns
The new length of the array, after the specified values are appended to it.
Description
push( )
appends its arguments, in order, to the
end of array
. It modifies
array
directly, rather than creating a new
array. push( )
, and its companion method
pop( )
, use arrays to provide the functionality of
a first in, last out stack. See Array.pop( ) for an
example.
Bugs
In Netscape’s implementations of JavaScript, when the language version is explicitly set to 1.2 this function returns the last value appended, rather than returning the new array length.
See Also
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.