Mozilla Developer NetworkSummary
Joins all elements of an array into a string.
Method of Array |
|
|---|---|
| Implemented in | JavaScript 1.1 |
| ECMAScript Edition | ECMAScript 1st Edition |
Syntax
string = array.join(separator)Parameters
separator- Specifies a string to separate each element of the array. The separator is converted to a string if necessary. If omitted, the array elements are separated with a comma.
Description
The string conversions of all array elements are joined into one string.
Examples
Example: Joining an array three different ways
The following example creates an array, a, with three elements, then joins the array three times: using the default separator, then a comma and a space, and then a plus.
var a = new Array("Wind","Rain","Fire");
var myVar1 = a.join(); // assigns "Wind,Rain,Fire" to myVar1
var myVar2 = a.join(", "); // assigns "Wind, Rain, Fire" to myVar2
var myVar3 = a.join(" + "); // assigns "Wind + Rain + Fire" to myVar3