【Node.js24.x】Array::flat()メソッドの使い方
flatメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
flatメソッドは、配列のネスト（入れ子）構造を解消し、指定された深さまで新しい一次元の配列を生成するメソッドです。これは、複数の配列が入れ子になっている場合に、それらを一つにまとめる際に非常に役立ちます。
このメソッドはオプションでdepthという引数を受け取ります。depthは数値を指定し、配列の入れ子をどこまで平坦化するかを決定します。例えば、depthに1を指定すると、一段階だけ入れ子になった配列が展開されます。depthを省略した場合のデフォルト値も1です。もし、配列がどれだけ深く入れ子になっていても、その全てを一次元に平坦化したい場合は、Infinityという特別な値をdepthに指定することができます。
flatメソッドは、元の配列を変更せず、常に新しい配列を返します。このため、元のデータ構造を保ちながら、操作しやすい形に変換することが可能です。システム開発において、複雑な階層を持つデータをシンプルに扱いたい場面などで、データの整形や加工処理に利用されます。例えば、複数のソースから集められたデータを統合する際などに、データの構造を統一し、処理を簡素化するために使われます。
構文(syntax)
1const originalArray = [1, [2, 3], [4, [5, 6]]]; 2const flattenedArray = originalArray.flat(); 3console.log(flattenedArray);
引数(parameters)
depth = 1
- depth: number = 1: 配列を平坦化する深さを指定します。デフォルトは1です。
戻り値(return)
Array
指定された配列を、指定された深さまでネスト解除（フラット化）した新しい配列を返します。