Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.map: transformace prvků

map volá callback pro existující prvky a vytváří nové výsledné pole se stejnou délkou.

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

Syntaxe

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) vytvoří nové pole, jehož délka se zachytí před prvním voláním callbacku. Pro každý existující index vzestupně zavolá callbackFn(value, index, array) a vrácenou hodnotu uloží na stejný index. Díry přeskakuje a ve výsledku zůstávají dírami.

Prvky přidané za počáteční délku nenavštíví; změna či odstranění dosud nenavštíveného indexu ovlivní jeho pozdější krok. thisArg poskytne this běžné funkci, ale nezmění lexikální this arrow funkce. Samotná metoda příjemce nemění, callback však může. Nevolatelný callback nebo příjemce null či undefined vyvolá TypeError; chyby callbacku a zápisu výsledku se šíří. Metoda je obecná pro array-like hodnoty.

Příklady

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

Výsledek

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

Zdroje