← 返回首页
Array.prototype.flatMap() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnología web para desarrolladores
  2. JavaScript
  3. Referencia de JavaScript
  4. Objetos globales
  5. Array
  6. Array.prototype.flatMap()
Theme
  • OS default
  • Light
  • Dark
Español
Remember language Learn more

Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Array.prototype.flatMap()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since enero de 2020.

El método flatMap() primero mapea cada elemento usando una función de mapeo, luego aplana el resultado en una nueva matriz. Es idéntico a un map seguido de un flattende profundidad 1, pero flatMap es a menudo útil y la fusión de ambos en un método es ligeramente más eficiente.

In this article

Pruébalo

const arr1 = [1, 2, 1]; const result = arr1.flatMap((num) => (num === 2 ? [2, 2] : 1)); console.log(result); // Expected output: Array [1, 2, 2, 1]

Sintaxis

var new_array = arr.flatMap(function callback(currentValue[, index[, array]]) { // return element for new_array }[, thisArg])

Parámetros

callback

Función que produce un elemento de la nueva matriz, tomando tres argumentos:

currentValue

El elemento actual que se procesa en la matriz.

indexOpcional

El índice del elemento actual que se procesa en la matriz.

arrayOpcional

La matriz map fue llamada.

thisArgOpcional

Valor para usar como this al ejecutar callback.

Valor de retorno

Una nueva matriz con cada elemento es el resultado de la función de devolución de llamada y se aplana a una profundidad de 1.

Descripción

Ver Array.prototype.map() para una descripción detallada de la función de devolución de llamada. El método flatMap es idéntico a map seguido de una llamada a flatten de profundidad 1.

Ejemplos

map y flatMap

js
var arr1 = [1, 2, 3, 4]; arr1.map((x) => [x * 2]); // [[2], [4], [6], [8]] arr1.flatMap((x) => [x * 2]); // [2, 4, 6, 8] // solo un nivel es aplanado arr1.flatMap((x) => [[x * 2]]); // [[2], [4], [6], [8]]

//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]

Alternativa

reduce y concat

js
var arr1 = [1, 2, 3, 4]; arr1.flatMap((x) => [x * 2]); // es equivalente a arr1.reduce((acc, x) => acc.concat([x * 2]), []); // [2, 4, 6, 8]

//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]

Polyfill

Este polyfill necesita Array.prototype.flat polyfill

js
if (!Array.prototype.flatMap) { Array.prototype.flatMap = function () { return Array.prototype.map.apply(this, arguments).flat(1); }; }

Especificaciones

Specification
ECMAScript® 2027 Language Specification
# sec-array.prototype.flatmap

Compatibilidad con navegadores

Enable JavaScript to view this browser compatibility table.

Ver también

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 24 jun 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos globales
  2. Array
  3. Constructor
    1. Array() constructor
  4. Métodos estáticos
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. Propiedades estáticas
    1. get Array[@@species]
  6. Métodos de instancia
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. toReversed()
    33. Array.prototype.toSorted()
    34. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. with()
    39. Array.prototype[@@iterator]()
  7. Propiedades de instancia
    1. Array.prototype.length
    2. Array.prototype[@@unscopables]
  8. Herencia
  9. Object/Function
  10. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Propiedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.prototype.arguments
    6. Function.caller
  12. Métodos de instancia
    1. Object.prototype.__defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. Propiedades de instancia
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.