Array.prototype.flatMap()

Dies ist eine experimentelle Technologie
Da diese Technologie noch nicht definitiv implementiert wurde, sollte die Browserkompatibilität beachtet werden. Es ist auch möglich, dass die Syntax in einer späteren Spezifikation noch geändert wird.

Die flatMap() Methode bildet jedes Element über eine Funktion ab und flacht das Ergebnis in ein Array ab. Sie ist identisch zu einem map gefolgt von einem flat der Tiefe 1, aber flatMap ist oft nützlich und beide in einer Methode zusammenführen ist etwas effizienter.

Syntax

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

Parameter

callback
Funktion, die ein Element für das neue Array erzeugt, welche drei Argumente hat:
 
currentValue
Das aktuelle Element, das im Array verarbeitet wird.
indexOptional
Der Index des aktuell zu verarbeitende Elements in dem Array.
arrayOptional
Das Array, auf dem flatMap aufgerufen wurde.
thisArgOptional
Wert, der bei der Ausführung von callback für this genutzt wird.

Rückgabewert

Ein neues Array mit jedem Element, dass aus dem Resultat der callback Funktion hervorgeht und auf die Tiefe 1 abgeflacht wurde.

Beschreibung

Siehe auf der Seite Array.prototype.map() für eine detaillierte Beschreibung der callback Funktion. Die flatMap Methode ist identisch zu map gefolgt von flat mit der Tiefe 1.

Beispiele

map und 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]

// only one level is flattened
arr1.flatMap(x => [[x * 2]]);
// [[2], [4], [6], [8]]

Alternative

reduce und concat

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

arr1.flatMap(x => [x * 2]);
// ist equivalent zu
arr1.reduce((acc, x) => acc.concat([x * 2]), []);
// [2, 4, 6, 8]
//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]

Spezifikationen

Spezifikation Status Kommentar
Array.prototype.flatMap proposal Candidate (3)  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
flatMapChrome Vollständige Unterstützung 69Edge Vollständige Unterstützung 79Firefox Vollständige Unterstützung 62IE Keine Unterstützung NeinOpera Vollständige Unterstützung 56Safari Vollständige Unterstützung 12WebView Android Vollständige Unterstützung 69Chrome Android Vollständige Unterstützung 69Firefox Android Vollständige Unterstützung 62Opera Android Vollständige Unterstützung 48Safari iOS Vollständige Unterstützung 12Samsung Internet Android Vollständige Unterstützung 10.0nodejs Vollständige Unterstützung 11.0.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Array
  3. Eigenschaften
    1. Array.prototype.length
    2. Array.prototype[@@unscopables]
  4. Methoden
    1. Array.from()
    2. Array.isArray()
    3. Array.observe()
    4. Array.of()
    5. Array.prototype.concat()
    6. Array.prototype.copyWithin()
    7. Array.prototype.entries()
    8. Array.prototype.every()
    9. Array.prototype.fill()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat()
    14. Array.prototype.flatMap()
    15. Array.prototype.forEach()
    16. Array.prototype.includes()
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys()
    20. Array.prototype.lastIndexOf()
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight()
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort()
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString()
    33. Array.prototype.toSource()
    34. Array.prototype.toString()
    35. Array.prototype.unshift()
    36. Array.prototype.values()
    37. Array.prototype[@@iterator]()
    38. Array.unobserve()
    39. get Array[@@species]
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]