CKTIS / JavaScript
Array.prototype.map: transformação de elementos
map chama um callback para os elementos existentes e cria um novo array de resultados com o mesmo comprimento.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.map(callbackFn[, thisArg])array.map(callbackFn[, thisArg]) cria um array novo cujo comprimento é capturado antes da primeira chamada. Para cada índice existente por ordem crescente chama callbackFn(value, index, array) e guarda o valor devolvido no mesmo índice. As posições vazias são ignoradas e continuam vazias no resultado.
Elementos acrescentados além do comprimento inicial não são visitados; alterar ou eliminar um índice ainda não visitado afeta o passo posterior. thisArg fornece this a uma função comum, mas não muda o this lexical de uma arrow function. O método não altera por si o recetor, embora o callback possa fazê-lo. Um callback não invocável ou um recetor null ou undefined lança TypeError; erros do callback ou da escrita do resultado propagam-se. É genérico para valores array-like.
Exemplos
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(","));Resultado
3 false 4||8 0:3,2:3 1,3 1,2,3