Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.map: transformación de elementos

map llama a un callback para los elementos existentes y crea un array de resultados nuevo con la misma longitud.

Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxis

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) crea un array nuevo cuya longitud se captura antes de la primera llamada. Para cada índice existente en orden ascendente llama a callbackFn(value, index, array) y guarda el valor devuelto en el mismo índice. Los huecos se omiten y siguen siendo huecos en el resultado.

No visita elementos añadidos más allá de la longitud inicial; cambiar o eliminar un índice aún no visitado afecta a su paso posterior. thisArg proporciona this a una función ordinaria, pero no cambia el this léxico de una función flecha. El método no muta por sí mismo, aunque el callback sí puede hacerlo. Un callback no invocable o un receptor null o undefined lanza TypeError; se propagan errores del callback o al escribir el resultado. Es genérico para valores array-like.

Ejemplos

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

Fuentes