CKTIS / JavaScript
Array.prototype.map: elementen transformeren
map roept een callback aan voor bestaande elementen en maakt een nieuwe resultaatarray met dezelfde lengte.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.map(callbackFn[, thisArg])array.map(callbackFn[, thisArg]) maakt een nieuwe array waarvan de lengte vóór de eerste callback wordt vastgelegd. Voor elke bestaande index in oplopende volgorde roept het callbackFn(value, index, array) aan en bewaart het resultaat op dezelfde index. Gaten worden overgeslagen en blijven gaten in het resultaat.
Elementen die voorbij de beginlengte worden toegevoegd, worden niet bezocht; wijzigen of verwijderen van een nog niet bezochte index beïnvloedt de latere stap. thisArg levert this aan een gewone functie, maar verandert de lexicale this van een arrow function niet. De methode zelf muteert niet, hoewel de callback dat kan. Een niet-aanroepbare callback of null of undefined als ontvanger werpt TypeError; callback- en schrijffouten worden doorgegeven. De methode is generiek voor array-achtige waarden.
Voorbeelden
const source = [2, , 4];
const seen = [];
const doubled = source.map((value, index, array) => {
seen.push(index + ":" + array.length);
return value * 2;
});
console.log(doubled.length, 1 in doubled, doubled.join("|"));
console.log(seen.join(","));
const growing = [1, 2];
const result = growing.map((value, index) => {
if (index === 0) growing.push(3);
return value + index;
});
console.log(result.join(","), growing.join(","));Resultaat
3 false 4||8 0:3,2:3 1,3 1,2,3