JavaScript flatMap()Метод
Пример
Примените функцию отображения к каждому элементу, затем сгладьте результат в новый массив:
Попробуйте »
Определение и использование
Метод flatMap() сначала отображает каждый элемент с помощью функции отображения, затем сглаживает результат в новый массив. Он почти идентичен map, за которым следует flat со значением глубины 1, но flatMap обычно немного эффективнее при объединении в один метод.
Метод flatMap() возвращает новый массив, где каждый элемент является результатом функции обратного вызова, а значение глубины структуры равно 1.
Поддержка браузеров
Числа в таблице указывают первую версию браузера, которая поддерживает метод.
| Метод | |||||
|---|---|---|---|---|---|
| flatMap() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
Синтаксис
// 箭头函数
flatMap((currentValue) => { /* … */ } )
flatMap((currentValue, index) => { /* … */ } )
flatMap((currentValue, index, array) => { /* … */ } )
// 回调函数
flatMap(callbackFn)
flatMap(callbackFn, thisArg)
// 行内回调函数
flatMap(function(currentValue) { /* … */ })
flatMap(function(currentValue, index) { /* … */ })
flatMap(function(currentValue, index, array){ /* … */ })
flatMap(function(currentValue, index, array) { /* … */ }, thisArg)
Parameters
| Parameters | Описание |
| callback | Функция, которая может генерировать элементы в новом массиве; она может принимать три параметра:
|
| thisArg | Необязательный. Значение this, используемое при выполнении функции обратного вызова. |
Технические детали
| Возвращаемое значение: | Массив. |
| Версия JavaScript: | ECMAScript 6 |
Другие примеры
map() и flatMap()
Пример
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, здесь показано только использование flatMap.
Итак, чтобы лучше продемонстрировать роль flatMap, ниже мы разбиваем массив, содержащий несколько предложений, на новый массив, состоящий из отдельных слов.
Пример
arr1.map(x => x.split(" "));
// [["it's","Sunny","in"],[""],["California"]]
arr1.flatMap(x => x.split(" "));
// ["it's","Sunny","in", "", "California"]
Обратите внимание, что длина выходного списка может отличаться от длины входного списка.
Добавление или удаление некоторых элементов во время map()
flatMap можно использовать для добавления или удаления элементов во время map (то есть для изменения количества элементов). Иными словами, он позволяет перебирать множество элементов и превращать их в другие элементы (обрабатывая их по отдельности), а не всегда быть один к одному. В этом смысле его функция похожа на противоположность filter. Просто верните массив из 1 элемента, чтобы сохранить элемент, верните массив из нескольких элементов, чтобы добавить элементы, или верните массив из 0 элементов, чтобы удалить элемент.
Пример
let a = [5, 4, -3, 20, 17, -33, -4, 18]
// |\ \ x | | \ x x |
// [4,1, 4, 20, 16, 1, 18]
a.flatMap( (n) =>
(n < 0) ? [] :
(n % 2 == 0) ? [n] :
[n-1, 1]
)
// ожидаемый вывод: [4, 1, 4, 20, 16, 1, 18]
Альтернативы
reduce() и concat()
Пример
arr.flatMap(x => [x, x * 2]);
// эквивалентно
arr.reduce((acc, x) => acc.concat([x, x * 2]), []);
// [1, 2, 2, 4, 3, 6, 4, 8]
Обратите внимание, что это неэффективно и этого следует избегать при работе с большими массивами: на каждой итерации создаётся новый временный массив, который должен быть собран сборщиком мусора, и он копирует элементы из текущего массива-аккумулятора в новый массив вместо добавления новых элементов в существующий массив.
Другие расширения
Объект Array в JavaScript