CKTIS / JavaScript
Array.prototype.flatMap: mappen en één niveau afvlakken
flatMap mapt bestaande elementen en spreidt callback-arrays precies één niveau.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.flatMap(callbackFn[, thisArg])array.flatMap(callbackFn[, thisArg]) roept callbackFn(value, index, array) voor bestaande indexen aan en spreidt elk Array-resultaat één niveau in een nieuwe array. Een niet-Array blijft één element; diepere nesting en gewone array-achtige objecten worden niet verder afgevlakt.
De beginlengte ligt vast, gaten worden overgeslagen en het ondiepe resultaat volgt species. De callback kan [] retourneren om over te slaan of meerdere waarden om uit te breiden. Niet-aanroepbare callback of ontvanger null/undefined werpt TypeError; uitzonderingen worden doorgegeven. Een Promise wordt niet afgewacht. Het voorbeeld slaat een gat over en maakt twee waarden per bezoek.
Voorbeelden
const source = [1, , 2];
let visits = 0;
const result = source.flatMap(value => { visits++; return [value, value * 10]; });
console.log(result.join(","));
console.log(visits);Resultaat
1,10,2,20 2