JavaScript flatMap()Метод

Array 对象参考手册Объект Array в JavaScript

Пример

Примените функцию отображения к каждому элементу, затем сгладьте результат в новый массив:

const arr1 = [1, 2, [3], [4, 5], 6, []]; const flattened = arr1.flatMap(num => num); document.getElementById("demo").innerHTML = flattened;

Попробуйте »

Определение и использование

Метод 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

Функция, которая может генерировать элементы в новом массиве; она может принимать три параметра:

currentValue

Текущий элемент, обрабатываемый в массиве

indexOptional

Необязательный. Индекс текущего элемента, обрабатываемого в массиве.

arrayOptional

Необязательный. Вызываемыйmaparray

thisArgНеобязательный. Значение this, используемое при выполнении функции обратного вызова.

Технические детали

Возвращаемое значение: Массив.
Версия JavaScript: ECMAScript 6

Другие примеры

map() и flatMap()

Пример

var 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, здесь показано только использование flatMap.

Итак, чтобы лучше продемонстрировать роль 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"]

Обратите внимание, что длина выходного списка может отличаться от длины входного списка.

Добавление или удаление некоторых элементов во время map()

flatMap можно использовать для добавления или удаления элементов во время map (то есть для изменения количества элементов). Иными словами, он позволяет перебирать множество элементов и превращать их в другие элементы (обрабатывая их по отдельности), а не всегда быть один к одному. В этом смысле его функция похожа на противоположность filter. Просто верните массив из 1 элемента, чтобы сохранить элемент, верните массив из нескольких элементов, чтобы добавить элементы, или верните массив из 0 элементов, чтобы удалить элемент.

Пример

// Допустим, мы хотим удалить все отрицательные числа и разбить нечётные числа на чётное число и 1
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()

Пример

var arr = [1, 2, 3, 4];

arr.flatMap(x => [x, x * 2]);
// эквивалентно
arr.reduce((acc, x) => acc.concat([x, x * 2]), []);
// [1, 2, 2, 4, 3, 6, 4, 8]

Обратите внимание, что это неэффективно и этого следует избегать при работе с большими массивами: на каждой итерации создаётся новый временный массив, который должен быть собран сборщиком мусора, и он копирует элементы из текущего массива-аккумулятора в новый массив вместо добавления новых элементов в существующий массив.



Array 对象参考手册Объект Array в JavaScript

Другие расширения