Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Array.prototype.map: preoblikovanje elementov

map pokliče callback za obstoječe elemente in ustvari novo tabelo rezultatov enake dolžine.

Različica: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaksa

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) ustvari novo tabelo, katere dolžina se zajame pred prvim klicem callbacka. Za vsak obstoječ indeks v naraščajočem vrstnem redu pokliče callbackFn(value, index, array) in vrnjeno vrednost shrani na isti indeks. Prazna mesta preskoči in v rezultatu ostanejo prazna.

Elementov, dodanih za začetno dolžino, ne obišče; sprememba ali izbris še neobiskanega indeksa vpliva na njegov poznejši korak. thisArg poda this navadni funkciji, ne spremeni pa leksikalnega this puščične funkcije. Metoda sama ne mutira prejemnika, callback pa ga lahko. Callback, ki ni funkcija, ali prejemnik null oziroma undefined sproži TypeError; napake callbacka in zapisa se širijo. Metoda je splošna za array-like vrednosti.

Primeri

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

Rezultat

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

Viri