Reduce a list of values using promises into a promise for a value
Last updated a year ago by sindresorhus .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install p-reduce 
SYNC missed versions from official npm registry.

p-reduce Build Status

Reduce a list of values using promises into a promise for a value

Useful when you need to calculate some accumulated value based on async resources.


$ npm install p-reduce


const pReduce = require('p-reduce');
const humanInfo = require('human-info'); // Not a real module

(async () => {
	const names = [
		getUser('sindresorhus').then(info => info.name),
		'Addy Osmani',
		'Pascal Hartig',
		'Stephen Sawchuk'

	const totalAge = await pReduce(names, async (total, name) => {
		const info = await humanInfo(name);
		return total + info.age;
	}, 0);

	//=> 125


pReduce(input, reducer, [initialValue])

Returns a Promise that is fulfilled when all promises in input and ones returned from reducer are fulfilled, or rejects if any of the promises reject. The fulfilled value is the result of the reduction.


Type: Iterable<Promise|any>

Iterated over serially in the reducer function.

reducer(previousValue, currentValue, index)

Type: Function

Expected to return a value. If a Promise is returned, it's awaited before continuing with the next iteration.


Type: unknown

Value to use as previousValue in the first reducer invocation.



MIT © Sindre Sorhus

Current Tags

  • 2.1.0                                ...           latest (a year ago)

3 Versions

  • 2.1.0                                ...           a year ago
  • 2.0.0                                ...           a year ago
  • 1.0.0                                ...           4 years ago
Maintainers (1)
Today 776
This Week 18,335
This Month 66,924
Last Day 9,443
Last Week 43,760
Last Month 189,298
Dependencies (0)
Dev Dependencies (4)
Dependents (99)

Copyright 2014 - 2016 © taobao.org |