JavaScript Array flatMap()

定義和用法

flatMap() 方法對數組中的每個元素執行映射操作,并創建新的扁平化數組。

flatMap() 通過為每個數組元素調用一個函數來創建新數組。

flatMap() 不會為空的數組元素執行函數。

flatMap() 不會改變原始數組。

另請參閱:

Array map() 方法

Array flat() 方法

Array filter() 方法

Array forEach() 方法

實例

const myArr = [1, 2, 3, 4, 5, 6];
const newArr = myArr.flatMap(x => [x, x * 10]);

親自試一試

語法

array.flatMap(function(currentValue, index, arr), thisValue)

參數

參數 描述
function() 必需。為每個數組元素運行的函數。
currentValue 必需。當前元素的值。
index 可選。當前元素的索引。
arr 可選。當前元素所屬的數組。
thisValue

可選。傳遞給函數的 this 值。

默認值為 undefined。

返回值

類型 描述
數組 數組,包含回調函數的結果元素,并將其扁平化。

瀏覽器支持

自 2020 年 1 月起,所有現代瀏覽器均支持 JavaScript 數組 flatMap() 方法:

Chrome Edge Firefox Safari Opera
Chrome 69 Edge 79 Firefox 62 Safari 12 Opera 56
2018 年 9 月 2020 年 1 月 2018 年 9 月 2018 年 9 月 2018 年 9 月