Async Array functions in NodeJS

asyncArrayFunction.js

/**
 * This module provides a set of async friendly functions that
 * mirror the non-async versions in array.
 *
 * They are not necessarily optimised, but they do work when we
 * need to deal with async or promise based operations in the
 * handler.
 */

/**
 * This is equivalent to Array.map, but with support for
 * async functions.
 *
 * @param array
 * @param handler
 */
async function map (array: Array<any>, handler: Function) {
  const newArray = [];

  for (let i = 0; i < array.length; i++) {
    newArray[i] = await handler(array[i]);
  }

  return newArray;
}

/**
 * This is equivalent to Array.forEach, but with support for
 * async functions.
 *
 * @param array
 * @param handler
 */
async function forEach (array: Array<any>, handler: Function) {
  const newArray = [];

  for (let i = 0; i < array.length; i++) {
    newArray[i] = await handler(array[i]);
  }

  return newArray;
}

export default { map, forEach };

export {
  map as asyncMap,
  forEach as asyncForEach
};