asyncReduce

La fonction asyncReduce() réduit un générateur à une seule valeur en appliquant une fonction d'accumulation asynchrone sur chaque élément. Version asynchrone de reduce().

Exemple interactif

Syntaxe

Signature classique

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

Signature currifiée

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

Paramètres

• iterator : Le générateur (synchrone ou asynchrone) à réduire
• startValue : Valeur initiale de l'accumulateur (utiliser DGenerator.reduceFrom() pour les objets)
• theFunction : Fonction asynchrone 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

Une Promise qui résout avec la valeur finale accumulée.

Voir aussi

• reduce - Version synchrone de asyncReduce
• asyncMap - Transforme avec une fonction asynchrone
• asyncFilter - Filtre avec une fonction asynchrone

Sources

• MDN Web Docs - Async iterators