Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Array.prototype.join()

概要

join() メソッドは、配列のすべての要素を繋いで文字列にします。

構文

str = arr.join([separator = ','])

引数

separator
任意。配列の各要素を区切る文字列を指定します。separator は、必要であれば文字列に変換されます。省略した場合、配列の要素はカンマで区切られます。separator に空文字列を渡した場合、すべての要素の間が区切り文字無しで繋がれます。

説明

配列のすべての要素を文字列に変換したものが、1 個の文字列に繋がれます。undefined または null の要素は、空文字列に変換されます。

例: 3 通りの異なる形で配列をつなぐ

以下の例は、3 個の要素を持つ配列 a を作成し、デフォルト引数、カンマとスペース、そして「と」と空文字を使った 4 パターンの結合を行っています。

var a = ["花", "太陽", "雨"];
var myVar1 = a.join();      // myVar1 に "花,太陽,雨" を代入
var myVar2 = a.join(", ");  // myVar2 に "花, 太陽, 雨" を代入
var myVar3 = a.join("と");  // myVar3 に "花と太陽と雨" を代入
var myVar4 = a.join('');    // myVar4 に "花太陽雨" を代入

仕様

仕様 状況 コメント
ECMAScript 1st Edition Standard Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard

ブラウザの実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 1.0 1.0 (1.7 or earlier) 5.5 (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: Marsf, teoli, ethertank, Mgjbot, Yuichirou
 最終更新者: Marsf,