Méthode map -- Le Coin Web de QuentinC

Vous êtes ici : Accueil > Référence HTML et JavaScript > Objet Array > Méthode map

Méthode map

Description

Effectue une copie du tableau original et exécute une fonction sur chaque élément de cette copie avant de la retourner. Contrairement à forEach le tableau de départ n'est pas affecté.

Syntaxe

Array map(Function callback)

Paramètres

Function callback : La fonction qui doit être appelée pour chaque élément du tableau.

Valeur de retour

Map retourne une copie du tableau d'origine avec les modifications effectuées.

Remarque

Remarque 1 : Cette fonction n'existe que depuis javascript 1.6, livrée avec toutes les versions de firefox 1.5 et supérieures. IL est néanmoins possible de faire quelques adaptations pour pouvoir l'utiliser sur Internet Explorer.

Remarque 2 : Les données du tableau d'origine ne sont pas moidifées. Les modifications sont effectuées sur une copie que map retourne à la fin du traitement. Si vous n'avez pas besoin de copier le tableau une deuxième fois en mémoire, utilisez forEach.

Remarque 3 : Les deux morceaux de code suivants sont parfaitement équivalents :


nouvelle_copie = tableau.map(fonction);

var nouvelle_copie = new Array();
for (var i = 0; i < tableau.length; i++) {
nouvelle_copie[i] = fonction(tableau[i]);
}