【JSリファレンス】Array.prototype.flat()

更新日:2024/06/14

初出:ECMAScript2019


Array.prototype.flat()は、Arrayオブジェクト(Arrayコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。
配列内の配列要素を展開した、新しい配列を返します。

欠番インデックスは無視され、生成後の配列は切り詰められます。

 

■構文

Array.prototype.flat ( [ depth ] )
  1. depth: 省略可能。規定値 1

    展開する配列の深さ

生成された配列

 

■使用例

const array = [1,2,[3,4],[5,6,[7,8]]];
const array2 = array.flat();
console.log( array2 ); // [ 1, 2, 3, 4, 5, 6, [ 7, 8 ] ]

const array3 = array.flat(2);
console.log( array3 ); // [ 1, 2, 3, 4, 5, 6, 7, 8  ]

 

■備考

call()等でアレイライクオブジェクトを対象にすることも可能です。
ただし、プロパティ値は配列である必要があります。

const arrayLike = {0:1,1:2,2:{0:4,1:5,length:2},length:3};
const array = Array.prototype.flat.call( arrayLike );
console.log( array ); // [ 1, 2, { '0': 4, '1': 5, length: 2 } ]

const arrayLike2 = {0:1,1:2,2:[4,5],length:3};
const array2 = Array.prototype.flat.call( arrayLike2 );
console.log( array2 ); // [ 1, 2, 4, 5 ]

更新日:2024/06/14

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。