Name
Array.concat( ): concatenate arrays â ECMAScript v3
Synopsis
array
.concat
(value
,
...)
Arguments
-
value, ...
Any number of values to be concatenated with
array
.
Returns
A new array, which is formed by concatenating each of the
specified arguments to array
.
Description
concat( )
creates and
returns a new array that is the result of concatenating each of its
arguments to array
. It does not modify
array
. If any of the arguments to
concat( )
is itself an array, the
elements of that array are concatenated, rather than the array
itself.
Example
var a = [1,2,3]; a.concat(4, 5) // Returns [1,2,3,4,5] a.concat([4,5]); // Returns [1,2,3,4,5] a.concat([4,5],[6,7]) // Returns [1,2,3,4,5,6,7] a.concat(4, [5,[6,7]]) // Returns [1,2,3,4,5,[6,7]]
See Also
Array.join( ), Array.push( ), Array.splice( )
Get JavaScript: The Definitive Guide, 5th 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.