Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.map: przekształcanie elementów

map wywołuje callback dla istniejących elementów i tworzy nową tablicę wyników o tej samej długości.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) tworzy nową tablicę o długości zapamiętanej przed pierwszym wywołaniem callbacku. Dla każdego istniejącego indeksu rosnąco wywołuje callbackFn(value, index, array), a zwróconą wartość zapisuje pod tym samym indeksem. Dziury są pomijane i pozostają dziurami w wyniku.

Elementy dopisane poza początkową długością nie są odwiedzane; zmiana lub usunięcie jeszcze nieodwiedzonego indeksu wpływa na późniejszy krok. thisArg ustawia this zwykłej funkcji, ale nie zmienia leksykalnego this funkcji strzałkowej. Odbiorca nie jest zmieniany przez samą metodę, choć callback może go zmienić. Callback niebędący funkcją oraz odbiorca null lub undefined powodują TypeError; błędy callbacku i zapisu wyniku są propagowane. Metoda jest generyczna dla array-like.

Przykłady

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(","));

Wynik

3 false 4||8
0:3,2:3
1,3 1,2,3

Źródła