JavaScript / コードを試す
入れ子の配列を平らにする
入れ子になった配列を1段階だけ、または全部平らにする方法をまとめます。flat() の深さ指定、 flatMap() で変換と平坦化を同時にやる書き方、穴が消える挙動まで実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
答え
flat() を使います。引数を省くと1段だけ平らになります。
const nested = [1, [2, 3], [4, [5]]]; console.log(nested.flat());
[ 1, 2, 3, 4, [ 5 ] ]
深さが分からないなら Infinity を渡します。
const deep = [1, [2, [3, [4]]]]; console.log(deep.flat(Infinity));
[ 1, 2, 3, 4 ]
何段まで平らにするか
引数は何段まで潰すかです。
const deep = [1, [2, [3, [4]]]]; console.log(deep.flat()); console.log(deep.flat(2)); console.log(deep.flat(Infinity));
[ 1, 2, [ 3, [ 4 ] ] ] [ 1, 2, 3, [ 4 ] ] [ 1, 2, 3, 4 ]
深さが分かっているなら数を書いてください。
Infinity は分かりやすい反面、「本当は2段のはず」という前提が消えます。
意図しない深さのデータが混ざっても、黙って平らになってしまいます。
変換しながら平らにする
map() の結果が配列になるときは、flatMap() が使えます。
const lines = ['a b', 'c d']; console.log(lines.map((line) => line.split(' '))); console.log(lines.flatMap((line) => line.split(' ')));
[ [ 'a', 'b' ], [ 'c', 'd' ] ] [ 'a', 'b', 'c', 'd' ]
flatMap() は map() してから flat() するのと同じです。
ただし平らにするのは1段だけで、深さは指定できません。
増やすことも減らすこともできる
返す配列の長さを変えれば、要素を増減できます。
const nums = [1, 2, 3]; console.log(nums.flatMap((n) => [n, n * 2])); console.log(nums.flatMap((n) => (n % 2 ? [n] : [])));
[ 1, 2, 2, 4, 3, 6 ] [ 1, 3 ]
空の配列を返すと、その要素は消えます。
filter() と map() を一度に書けるので、条件付きの変換で便利です。
読みやすさは場合によります。「絞る」と「変える」を分けたほうが分かりやすいなら、filter() と map() を繋げてください。
→ 配列を変換する・絞り込む
知っておくこと:穴が消える
flat() は、配列の穴を黙って取り除きます。
const holes = [1, , 2, [3, , 4]]; console.log(holes); console.log(holes.flat());
[ 1, <1 empty item>, 2, [ 3, <1 empty item>, 4 ] ] [ 1, 2, 3, 4 ]
平らにするだけのつもりが、長さが変わります。 穴のある配列を扱っているなら、要素数を当てにしないでください。
穴は undefined とは違います。[1, , 2] は「2番目が無い」という状態で、読み出すと undefined になるだけです。
→ 配列の基本
深さに 0 を渡すと何もしない
console.log([1, [2]].flat(0));
[ 1, [ 2 ] ]
変数から深さを渡すときに効いてきます。
flat(depth) の depth が0になる経路があると、
平らにならないまま先へ進みます。エラーは出ません。
深さが決まらないなら Infinity、決まるなら数を書く。
変数を渡すなら、0になり得ないか確かめてください。
長さがどう変わるか
console.log([[1], [2]].length); console.log([[1], [2]].flat().length);
2 2
外側の要素数と、平らにしたあとの要素数は一致するとは限りません。 中身が1つずつなら偶然そろいますが、数を当てにしないでください。
よくある間違い
元の配列が変わると思っている
const nested = [1, [2, 3]];
nested.flat();
console.log(nested);[ 1, [ 2, 3 ] ]
flat() は新しい配列を返すだけです。元は変わりません。
戻り値を受け取ってください。
オブジェクトの中の配列は平らにならない
const rows = [{ tags: ['a', 'b'] }, { tags: ['c'] }];
console.log(rows.flat());[ { tags: [ 'a', 'b' ] }, { tags: [ 'c' ] } ]flat() が見るのは配列の要素が配列かどうかだけです。
オブジェクトの中までは入りません。取り出してから平らにします。
const rows = [{ tags: ['a', 'b'] }, { tags: ['c'] }]; console.log(rows.flatMap((row) => row.tags));
[ 'a', 'b', 'c' ]
これが flatMap() のいちばん多い使い道です。
まとめ
flat()は引数を省くと1段。深さは数で指定する- 深さが不明なら
Infinity。ただし前提が消えることを承知で flatMap()は変換と平坦化を同時に。平らにするのは1段だけ- 空の配列を返せば要素を消せる
- 穴は黙って取り除かれる。 長さが変わる
- どちらも元の配列を変えない