KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen