Usage

const result = await reduce(
  [1, 2, 3],
  async (acc, item, index) => {
    return acc + (await computeOnGPU(item));
  },
  0,
);

Installation

CLI

npx atmx add helper reduce

Manually

Copy and paste the following method into @/utils/helpers/reduce.ts:

/**
* An async reduce function. Works like the built-in Array.reduce
* function but handles an async reducer function.
*
* @example
* const result = await reduce([1, 2, 3], async (acc, item, index) => {
*   return acc + (await computeOnGPU(item))
* }, 0)
*/
export async function reduce<T, K>(
array: readonly T[],
asyncReducer: (acc: K, item: T, index: number) => Promise<K>,
initValue?: K,
): Promise<K> {
const initProvided = initValue !== undefined;
if (!initProvided && array?.length < 1) {
throw new Error("Cannot reduce empty array with no init value");
}
const iter = initProvided ? array : array.slice(1);
let value: any = initProvided ? initValue : array[0];
for (const [i, item] of iter.entries()) {
value = await asyncReducer(value, item, i);
}
return value;
}