Name
Array.join( ) — concatenate array elements to form a string
Availability
JavaScript 1.1; JScript 2.0; ECMAScript v1
Synopsis
array
.join( )array
.join(separator
)
Arguments
-
separator
An optional character or string used to separate one element of the array from the next in the returned string. If this argument is omitted, a comma is used.
Returns
The string that results from converting each element of
array
to a string and then concatenating
them together, with the separator
string
between elements.
Description
join( )
converts each of the elements of an array
to a string and then concatenates those strings, inserting the
specified separator
string between the
elements. It returns the resulting string.
You can perform a conversion in the opposite
direction -- splitting a string up into array elements -- with
the split( )
method of the String object. See the String.split( ) reference page for details.
Example
a = new Array(1, 2, 3, "testing"); s = a.join("+"); // s is the string "1+2+3+testing"
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.