Function forEachAsync

lib/helper/WebDriver.js:2998–3012

* Mimic Array.forEach() API, but with an async callback function. * Execute each callback on each array item serially. Useful when using WebDriver API. * * Added due because of problem with chrome driver when too many requests * are made simultaneously. https://bugs.chromium.org/p/chromedriver/i

(array, callback, options = { expandArrayResults: true })

 * @return {Promise<Array>} - Array of values.
 */
async function forEachAsync(array, callback, options = { expandArrayResults: true }) {
  const { expandArrayResults = true } = options
  const inputArray = Array.isArray(array) ? array : [array]
  const values = []
  for (let index = 0; index < inputArray.length; index++) {
    const res = await callback(inputArray[index], index, inputArray)

    if (Array.isArray(res) && expandArrayResults) {
      res.forEach(val => values.push(val))
    } else if (res) {
      values.push(res)
    }
  }
  return values
}

/**
 * Mimic Array.filter() API, but with an async callback function.