WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen