JavaScript / コードを試す
join() — 配列を1本の文字列にする
join() は要素を区切り文字で繋ぎます。null と undefined が空文字になること、区切りを省くとカンマになること、入れ子の配列が平らに見えることまで実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
console.log([1, 2, 3].join('-')); console.log([1, 2, 3].join()); console.log([].join('-') === '');
1-2-3 1,2,3 true
引数を省くとカンマになります。空文字にしたいなら join('') と明示してください。
元の配列は変わりません。返るのは新しい文字列です。
null と undefined は空文字になる
ここがいちばん事故になります。
console.log([1, null, undefined, 2].join('-'));1---2
消えるのは値だけで、区切り文字は残ります。
「- が並んでいる」ことでしか気づけません。
落としたいなら、先に取り除いてください。
const values = [1, null, undefined, 2]; console.log(values.filter((v) => v != null).join('-'));
1-2
v != null は null と undefined の両方に当たります。ここでは意図した書き方です。
0 や空文字は残ります。
console.log([0, '', false, 'a'].join('-'));
0--false-a
false は 'false' になり、空文字だけが消えたように見えます。
穴も空文字になる
const holed = [1, , 2]; console.log(holed.length); console.log(holed.join('-'));
3 1--2
穴と undefined は繋いだ後では見分けが付きません。
入れ子は平らに見える
console.log([[1, 2], [3]].join('-'));
1,2-3
内側の配列は、自分のカンマで繋がれてから外側に並びます。 指定した区切りが効くのはいちばん外側だけです。
平らにしてから繋いでください。
console.log([[1, 2], [3]].flat().join('-'));
1-2-3
toString() と String() との関係
console.log([1, 2].toString()); console.log(String([1, 2])); console.log(`${[1, 2]}`); console.log([1, 2] + '');
1,2 1,2 1,2 1,2
どれも join() を呼んでいます。 区切りはカンマで固定です。
配列をそのまま文字列に混ぜると、この形になります。
意図してカンマ区切りにしたのか、うっかり混ざったのかが読み手に伝わりません。
繋ぐつもりなら join() と書いてください。
concat() は別のもの
join() は文字列を返し、concat() は配列を返します。
const a = [1, 2]; const b = [3]; console.log(a.concat(b)); console.log(a.concat(4, [5, [6]])); console.log(a);
[ 1, 2, 3 ] [ 1, 2, 4, 5, [ 6 ] ] [ 1, 2 ]
配列は1段だけ開かれ、それ以外はそのまま入ります。
a は変わっていません。
いまはスプレッド構文で書くほうが多いです。
concat() が要るのは、配列かどうか分からないものを混ぜるときです。要素なら1つとして、配列なら開いて入ります。
→ スプレッド構文と残余
逆向き:文字列を配列に戻す
const joined = [1, 2, 3].join('-'); console.log(joined.split('-')); console.log(joined.split('-').map(Number));
[ '1', '2', '3' ] [ 1, 2, 3 ]
戻ってくるのは文字列です。数として使うなら変換が要ります。 → String.prototype.split()
区切り文字が値の中にも入っていると、戻せません。
const names = ['田中', '佐藤・鈴木'];
const joined = names.join('・');
console.log(joined);
console.log(joined.split('・').length);田中・佐藤・鈴木 3
2件だったものが3件になりました。 値に含まれない区切りを選ぶか、JSON にしてください。 → JSON.parse() と JSON.stringify()
まとめ
- 引数を省くとカンマ。空文字なら
join('')と書く null/undefined/ 穴は空文字になり、区切りだけが残る0やfalseは残る- 入れ子は内側がカンマで繋がれる。先に
flat() String()も${}も+も、中ではjoin()を呼んでいるconcat()が返すのは配列- 値に区切り文字が入っていると元に戻せない