push() method mutates an array by appending the given elements and returning the new length of the array.
arr.push(element1, ..., elementN)
element1, ..., elementN
- The elements to add to the end of the array.
length property of the object upon which the method was called.
push method appends values to an array.
push is intentionally generic. This method can be
applied to objects resembling arrays. The
push method relies on a
length property to determine where to start inserting the given values. If the
length property cannot be converted into a number, the index used is 0. This includes the possibility of
length being nonexistent, in which case
length will also be created.
The only native, array-like objects are
Strings, although they are not suitable in applications of this method, as strings are immutable.
Example: Adding elements to an array
The following code creates the
sports array containing two elements, then appends two elements to it. The
total variable contains the new length of the array.
var sports = ["soccer", "baseball"]; var total = sports.push("football", "swimming"); console.log(sports); // ["soccer", "baseball", "football", "swimming"] console.log(total); // 4
|ECMAScript Language Specification 5.1th Edition (ECMA-262)||Standard|
|ECMAScript Language Specification 6th Edition (ECMA-262)||Draft|
|Feature||Chrome||Firefox (Gecko)||Internet Explorer||Opera||Safari|
|Basic support||1.0||1.0 (1.7 or earlier)||5.5||(Yes)||(Yes)|
|Feature||Android||Chrome for Android||Firefox Mobile (Gecko)||IE Mobile||Opera Mobile||Safari Mobile|