import findIndexLimit from './findIndexLimit.mjs'
/**
* Returns the index of the first element of an iterable that passes an asynchronous truth test.
*
* The calls to `iteratee` will run sequentially. As opposed to `findIndex()` and `findIndexLimit()` this ensures
* that if multiple values may pass the truth test it will be the first one of the iterable that will be
* returned.
*
* In case of exception in one of the `iteratee` calls the promise returned by this function will be
* rejected with the exception and the remaining pending tasks will be cancelled.
*
* @param {Iterable} iterable An iterable object.
* @param {Function} iteratee A function that will be called with each member of the iterable. It will receive
* three arguments:
* * `value`: The current value to process
* * `index`: The index in the iterable. Will start from 0.
* * `iterable`: The iterable on which the operation is being performed.
* @returns {Promise} A promise that will be resolved with the index of the first found value or rejected if one of the
* `iteratee` calls throws an exception before finding a value. If no value is found it will return `-1`.
* @example
* import { findIndexSeries, asyncRoot, sleep } from 'modern-async'
*
* asyncRoot(async () => {
* const array = [1, 2, 3]
* const result = await findIndexSeries(array, async (v) => {
* // these calls will be performed sequentially
* await sleep(Math.random() * 10) // waits a random amount of time between 0ms and 10ms
* return v % 2 === 1
* })
* console.log(result) // always prints 0
* })
*/
async function findIndexSeries (iterable, iteratee) {
return findIndexLimit(iterable, iteratee, 1)
}
export default findIndexSeries