Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.map: trasformazione degli elementi

map chiama un callback per gli elementi esistenti e crea un nuovo array di risultati della stessa lunghezza.

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

Sintassi

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) crea un nuovo array la cui lunghezza è acquisita prima della prima chiamata. Per ogni indice esistente in ordine crescente chiama callbackFn(value, index, array) e salva il valore restituito allo stesso indice. I vuoti vengono saltati e restano vuoti nel risultato.

Gli elementi aggiunti oltre la lunghezza iniziale non vengono visitati; cambiare o eliminare un indice non ancora visitato incide sul passaggio successivo. thisArg fornisce this a una funzione ordinaria, ma non cambia il this lessicale di una arrow function. Il metodo non muta da solo il ricevente, sebbene il callback possa farlo. Un callback non invocabile o un ricevente null o undefined genera TypeError; gli errori del callback o di scrittura si propagano. È generico per valori array-like.

Esempi

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

Risultato

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

Fonti