reduce

La fonction reduce() réduit un générateur à une seule valeur en appliquant une fonction d'accumulation sur chaque élément. Permet aussi de sortir prématurément avec exit().

Exemple interactif

Syntaxe

Signature classique

function reduce<
	GenericElement extends unknown,
	GenericReduceFrom extends GeneratorEligibleReduceFromValue,
>(
	iterator: Iterable<GenericElement>,
	startValue: GenericReduceFrom,
	theFunction: (
		params: GeneratorReduceFunctionParams<
			GenericElement,
			GeneratorReduceFromValue<GenericReduceFrom>
		>
	) => GeneratorReduceExitOrNext<GeneratorReduceFromValue<GenericReduceFrom>>
): GeneratorReduceFromValue<GenericReduceFrom>

Signature currifiée

function reduce<
	GenericElement extends unknown,
	GenericReduceFrom extends GeneratorEligibleReduceFromValue,
>(
	startValue: GenericReduceFrom,
	theFunction: (
		params: GeneratorReduceFunctionParams<
			GenericElement,
			GeneratorReduceFromValue<GenericReduceFrom>
		>
	) => GeneratorReduceExitOrNext<GeneratorReduceFromValue<GenericReduceFrom>>
): (iterator: Iterable<GenericElement>) => GeneratorReduceFromValue<GenericReduceFrom>

Paramètres

• iterator : Le générateur à réduire
• startValue : Valeur initiale de l'accumulateur (utiliser DGenerator.reduceFrom() pour les objets)
• theFunction : Fonction de réduction qui reçoit :
  • element : L'élément courant
  • index : L'index de l'élément
  • lastValue : La valeur accumulée précédente
  • next(value) : Continue avec une nouvelle valeur accumulée
  • exit(value) : Termine et retourne la valeur
  • nextWithObject(obj1, obj2) : Fusionne deux objets (disponible si lastValue est un objet)

Valeur de retour

La valeur finale accumulée.

Voir aussi

• asyncReduce - Version asynchrone de reduce
• map - Transforme les éléments d'un générateur
• filter - Filtre les éléments d'un générateur

Sources

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