Array.prototype.flatMap()
Метод flatMap()
сначала применяет функцию к каждому элементу, а затем преобразует полученый результат в плоскую структуру и помещает в новый массив. Это идентично map функции, с последующим применением функции flat с параметром depth ( глубина ) равным 1, но flatMap
часто бывает полезным, так как работает немного более эффективно.
{{EmbedInteractiveExample("pages/js/array-flatmap.html")}}
Исходный код данного примера расположен в GitHub репозитории. Если вы хотите улучшить этот пример, вам нужно склонировать https://github.com/mdn/interactive-examples внести в него измения и отправить их нам через PR ( pull request ).
Синтаксис
var new_array = arr.flatMap(function callback(currentValue[, index[, array]]) { // возращает элемент для new_array }[, thisArg])
Параметры
callback
- Функция которая производит элементы нового массива, принимает три аргумента:
currentValue
- Текущий обрабатываемый элемент массива.
index
Необязательный- Индекс обрабатываемого элемента в массиве.
array
Необязательный- Массив по которому осуществляется обход.
thisArg
Необязательный- Значение используемое в качестве
this
при вызове функцииcallback
.
Возвращаемое значение
Новый массив, каждый элемент которого является результатом выполнения функции callback и "поднят" на уровень 1.
Описание
Смотрите Array.prototype.map()
для детального описания callback функции. Метод flatMap
идентичен методу map
с последующим вызовом flat
с параметром depth 1.
Примеры
map
и flatMap
let arr1 = [1, 2, 3, 4];
arr1.map(x => [x * 2]);
// [[2], [4], [6], [8]]
arr1.flatMap(x => [x * 2]);
// [2, 4, 6, 8]
// выравнивается только один уровень
arr1.flatMap(x => [[x * 2]]);
// [[2], [4], [6], [8]]
Хотя результат полученый в примере выше можно было получить используя просто map, ниже мы рассмотрим пример где flatMap
является более эффективным.
Давайте сгенерируем список слов из списка предложений.
let arr1 = ["it's Sunny in", "", "California"];
arr1.map(x => x.split(" "));
// [["it's","Sunny","in"],[""],["California"]]
arr1.flatMap(x => x.split(" "));
// ["it's","Sunny","in", "", "California"]
Обратите внимание, длина списка вывода может отличаться от длины списка ввода.
Альтернативное решение
reduce
and concat
var arr1 = [1, 2, 3, 4];
arr1.flatMap(x => [x * 2]);
// is equivalent to
arr1.reduce((acc, x) => acc.concat([x * 2]), []);
// [2, 4, 6, 8]
Спецификация
Спецификация | Статус | Комментарий |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Array.prototype.flatMap' в этой спецификации. |
Стандарт |
Поддержка браузерами
BCD tables only load in the browser