map

La méthode map() applique une fonction de transformation sur chaque élément d'un tableau et retourne un nouveau tableau contenant les résultats, sans modifier l'entrée.

Exemple interactif

Syntaxe

Signature classique

function map<
	GenericInput extends readonly unknown[],
	GenericOutput extends unknown
>(
	input: GenericInput,
	theFunction: (
		element: GenericInput[number],
		params: ArrayMapParams<GenericInput>
	) => GenericOutput
): GenericOutput[]

Signature currifiée

function map<
	GenericInput extends readonly unknown[],
	GenericOutput extends unknown
>(
	theFunction: (
		element: GenericInput[number],
		params: ArrayMapParams<GenericInput>
	) => GenericOutput
): (input: GenericInput) => GenericOutput[]

Paramètres auxiliaires

interface ArrayMapParams<
	GenericInputArray extends readonly unknown[]
> {
	index: number;
	self: GenericInputArray;
}

Paramètres

• input : Le tableau à transformer.
• theFunction : Fonction appliquée à chaque élément. Elle reçoit l'élément courant et un objet fournissant l'index et le tableau complet.
• params.index : Position de l'élément en cours dans le tableau source.
• params.self : Le tableau complet (pratique pour comparer la position courante ou accéder aux voisins).

Valeur de retour

Un nouveau tableau contenant les valeurs retournées par la fonction de transformation. Le tableau original n'est jamais modifié.

Voir aussi

• filter - Filtre les éléments selon une condition
• flatMap - Transforme puis aplatit le résultat d'un niveau

Sources

• MDN Web Docs - Array.prototype.map()