p-map-series
Map over promises serially
Last updated a year ago by sindresorhus .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install p-map-series 
SYNC missed versions from official npm registry.

p-map-series Build Status

Map over promises serially

Useful as a side-effect mapper. Use p-map if you don't need side-effects, as it's concurrent.

Install

$ npm install p-map-series

Usage

const pMapSeries = require('p-map-series');

const keywords = [
	getTopKeyword() //=> Promise
	'rainbow',
	'pony'
];

let scores = [];

const mapper = async keyword => {
	const score = await fetchScore(keyword);
	scores.push(score);
	return {keyword, score};
});

(async () => {
	console.log(await pMapSeries(keywords, mapper));
	/*
	[
		{
			keyword: 'unicorn',
			score: 99
		},
		{
			keyword: 'rainbow',
			score: 70
		},
		{
			keyword: 'pony',
			score: 79
		}
	]
	*/
})();

API

pMapSeries(input, mapper)

Returns a Promise that is fulfilled when all promises in input and ones returned from mapper are fulfilled, or rejects if any of the promises reject. The fulfilled value is an Array of the mapper created promises fulfillment values.

input

Type: Iterable<Promise | unknown>

Mapped over serially in the mapper function.

mapper(element, index)

Type: Function

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

Related

  • p-each-series - Iterate over promises serially
  • p-reduce - Reduce a list of values using promises into a promise for a value
  • p-map - Map over promises concurrently
  • More…

License

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)
Downloads
Today 103
This Week 6,755
This Month 17,449
Last Day 1,794
Last Week 9,593
Last Month 37,868
Dependencies (0)
None
Dev Dependencies (5)

Copyright 2014 - 2016 © taobao.org |