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