CKTIS / JavaScript
Array.prototype.map: Elemente transformieren
map ruft für vorhandene Elemente einen Callback auf und erzeugt ein neues Ergebnis-Array gleicher Länge.
Version: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.map(callbackFn[, thisArg])array.map(callbackFn[, thisArg]) erzeugt ein neues Array, dessen Länge vor dem ersten Callback-Aufruf erfasst wird. Für jeden vorhandenen Index in aufsteigender Reihenfolge ruft es callbackFn(value, index, array) auf und speichert den Rückgabewert am selben Index. Lücken werden übersprungen und bleiben im Ergebnis Lücken.
Elemente jenseits der anfänglichen Länge werden nicht besucht; Ändern oder Löschen eines noch nicht besuchten Index beeinflusst den späteren Schritt. thisArg liefert this für eine normale Funktion, ändert aber nicht das lexikalische this einer Pfeilfunktion. Die Methode selbst mutiert nicht, der Callback kann es jedoch. Ein nicht aufrufbarer Callback oder null beziehungsweise undefined als Empfänger löst TypeError aus; Callback- und Schreibfehler werden weitergegeben. Die Methode ist für array-ähnliche Werte generisch.
Beispiele
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(","));Ergebnis
3 false 4||8 0:3,2:3 1,3 1,2,3