Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.map : transformation des éléments

map appelle une fonction pour les éléments présents et crée un nouveau tableau de même longueur.

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

Syntaxe

array.map(callbackFn[, thisArg])

array.map(callbackFn[, thisArg]) crée un nouveau tableau dont la longueur est capturée avant le premier appel. Pour chaque indice présent en ordre croissant, la méthode appelle callbackFn(value, index, array), puis stocke la valeur renvoyée au même indice. Les trous sont ignorés et restent des trous dans le résultat.

Les éléments ajoutés au-delà de la longueur initiale ne sont pas visités ; modifier ou supprimer un indice pas encore visité affecte son étape. thisArg fournit this à une fonction ordinaire, mais ne change pas le this lexical d’une fonction fléchée. La méthode elle-même ne modifie pas le receveur, mais le callback peut le faire. Un callback non appelable ou un receveur null ou undefined lève TypeError ; les erreurs du callback ou d’écriture se propagent. La méthode est générique pour les valeurs array-like.

Exemples

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

Résultat

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

Sources