You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
1.6 KiB
65 lines
1.6 KiB
1 month ago
|
declare const stop: unique symbol;
|
||
|
|
||
|
declare namespace pEachSeries {
|
||
|
type StopSymbol = typeof stop;
|
||
|
}
|
||
|
|
||
|
declare const pEachSeries: {
|
||
|
/**
|
||
|
Iterate over promises serially.
|
||
|
|
||
|
@param input - Iterated over serially in the `iterator` function.
|
||
|
@param iterator - Return value is ignored unless it's `Promise`, then it's awaited before continuing with the next iteration.
|
||
|
@returns A `Promise` that fulfills when all promises in `input` and ones returned from `iterator` are fulfilled, or rejects if any of the promises reject. The fulfillment value is the original `input`.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import pEachSeries = require('p-each-series');
|
||
|
|
||
|
const keywords = [
|
||
|
getTopKeyword(), //=> Promise
|
||
|
'rainbow',
|
||
|
'pony'
|
||
|
];
|
||
|
|
||
|
const iterator = async element => saveToDiskPromise(element);
|
||
|
|
||
|
(async () => {
|
||
|
console.log(await pEachSeries(keywords, iterator));
|
||
|
//=> ['unicorn', 'rainbow', 'pony']
|
||
|
})();
|
||
|
```
|
||
|
*/
|
||
|
<ValueType>(
|
||
|
input: Iterable<PromiseLike<ValueType> | ValueType>,
|
||
|
iterator: (element: ValueType, index: number) => pEachSeries.StopSymbol | unknown
|
||
|
): Promise<ValueType[]>;
|
||
|
|
||
|
/**
|
||
|
Stop iterating through items by returning `pEachSeries.stop` from the iterator function.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
const pEachSeries = require('p-each-series');
|
||
|
|
||
|
// Logs `a` and `b`.
|
||
|
const result = await pEachSeries(['a', 'b', 'c'], value => {
|
||
|
console.log(value);
|
||
|
|
||
|
if (value === 'b') {
|
||
|
return pEachSeries.stop;
|
||
|
}
|
||
|
});
|
||
|
|
||
|
console.log(result);
|
||
|
//=> ['a', 'b', 'c']
|
||
|
```
|
||
|
*/
|
||
|
readonly stop: pEachSeries.StopSymbol;
|
||
|
|
||
|
// TODO: Remove this for the next major release
|
||
|
default: typeof pEachSeries;
|
||
|
};
|
||
|
|
||
|
export = pEachSeries;
|