Array.prototype.join()

Summary

The join() method joins all elements of an array into a string.

Syntax

str = arr.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

Specifications

Specification Status Comment
ECMAScript 1st Edition Standard Initial definition.
Implemented in JavaScript 1.1
ECMAScript Language Specification 5.1th Edition (ECMA-262) Standard  
ECMAScript Language Specification 6th Edition (ECMA-262) Draft  

Browser compatibility

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
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

See also

Document Tags and Contributors

Last updated by: fscholz,
Hide Sidebar