index.js
 1  'use strict';
 2  const pLimit = require('p-limit');
 3  
 4  class EndError extends Error {
 5  	constructor(value) {
 6  		super();
 7  		this.value = value;
 8  	}
 9  }
10  
11  // The input can also be a promise, so we await it
12  const testElement = async (element, tester) => tester(await element);
13  
14  // The input can also be a promise, so we `Promise.all()` them both
15  const finder = async element => {
16  	const values = await Promise.all(element);
17  	if (values[1] === true) {
18  		throw new EndError(values[0]);
19  	}
20  
21  	return false;
22  };
23  
24  const pLocate = async (iterable, tester, options) => {
25  	options = {
26  		concurrency: Infinity,
27  		preserveOrder: true,
28  		...options
29  	};
30  
31  	const limit = pLimit(options.concurrency);
32  
33  	// Start all the promises concurrently with optional limit
34  	const items = [...iterable].map(element => [element, limit(testElement, element, tester)]);
35  
36  	// Check the promises either serially or concurrently
37  	const checkLimit = pLimit(options.preserveOrder ? 1 : Infinity);
38  
39  	try {
40  		await Promise.all(items.map(element => checkLimit(finder, element)));
41  	} catch (error) {
42  		if (error instanceof EndError) {
43  			return error.value;
44  		}
45  
46  		throw error;
47  	}
48  };
49  
50  module.exports = pLocate;
51  // TODO: Remove this for the next major release
52  module.exports.default = pLocate;