forEachAsync

The async counterpart to Array.prototype.forEach: runs fn for every item for its side effects, discarding any return value. Prefer mapAsync when you need the results — this only exists to signal that intent clearly, same as the sync forEach/map pair.

Available since v3.0.4

Import

import { forEachAsync } from '@helpers4/array';
// or, from the all-in-one package (same code, one install):
import { forEachAsync } from 'helpers4/array';

Signature

forEachAsync<T>(array: readonly T[], fn: function, concurrency?: number): Promise<void>

Parameters

Parameter	Type	Description
array	readonly T[]	The array to iterate
fn	function	Async (or sync) function called with `(item, index)`
concurrency	number	Maximum number of concurrent calls. Defaults to unlimited. (optional)

Returns

Promise<void> — A promise that resolves once every call has settled

Examples

Upload files with a concurrency cap

Runs fn for its side effects only; at most concurrency calls at once.

await forEachAsync(files, (file) => uploadFile(file), 3)
// uploads at most 3 files concurrently

Source

View source on GitHub