2020-08-25 23:57:08 +00:00
|
|
|
'use strict';
|
|
|
|
const pLimit = require('p-limit');
|
|
|
|
|
|
|
|
class EndError extends Error {
|
|
|
|
constructor(value) {
|
|
|
|
super();
|
|
|
|
this.value = value;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
// The input can also be a promise, so we await it
|
|
|
|
const testElement = async (element, tester) => tester(await element);
|
2020-08-25 23:57:08 +00:00
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
// The input can also be a promise, so we `Promise.all()` them both
|
|
|
|
const finder = async element => {
|
|
|
|
const values = await Promise.all(element);
|
|
|
|
if (values[1] === true) {
|
|
|
|
throw new EndError(values[0]);
|
|
|
|
}
|
|
|
|
|
|
|
|
return false;
|
|
|
|
};
|
|
|
|
|
|
|
|
const pLocate = async (iterable, tester, options) => {
|
|
|
|
options = {
|
2020-08-25 23:57:08 +00:00
|
|
|
concurrency: Infinity,
|
2022-11-10 10:43:16 +00:00
|
|
|
preserveOrder: true,
|
|
|
|
...options
|
|
|
|
};
|
2020-08-25 23:57:08 +00:00
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
const limit = pLimit(options.concurrency);
|
2020-08-25 23:57:08 +00:00
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
// Start all the promises concurrently with optional limit
|
|
|
|
const items = [...iterable].map(element => [element, limit(testElement, element, tester)]);
|
2020-08-25 23:57:08 +00:00
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
// Check the promises either serially or concurrently
|
|
|
|
const checkLimit = pLimit(options.preserveOrder ? 1 : Infinity);
|
2020-08-25 23:57:08 +00:00
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
try {
|
|
|
|
await Promise.all(items.map(element => checkLimit(finder, element)));
|
|
|
|
} catch (error) {
|
|
|
|
if (error instanceof EndError) {
|
|
|
|
return error.value;
|
|
|
|
}
|
|
|
|
|
|
|
|
throw error;
|
|
|
|
}
|
2020-08-25 23:57:08 +00:00
|
|
|
};
|
2022-11-10 10:43:16 +00:00
|
|
|
|
|
|
|
module.exports = pLocate;
|