forEach (Functional Programming) ​
Creates a function that runs a callback for each value and returns the input array. Use it with pipe.
typescript
const result = pipe(array, forEach(callback));INFO
This helper is specific to es-toolkit/fp. Use it when you want this operation as part of a pipe pipeline.
Usage ​
forEach is useful as a side-effect step in a pipeline. It calls callback for each value and passes the original array through. Inside pipe, it is lazy-capable when adjacent lazy operations can stop early.
typescript
import { forEach, pipe } from 'es-toolkit/fp';
const values: number[] = [];
pipe(
[1, 2, 3],
forEach(value => values.push(value))
); // => [1, 2, 3]
values; // => [1, 2, 3]Parameters ​
callback((value: T, index: number) => void): The function to run for each value.
Returns ​
((array: readonly T[]) => readonly T[]): A function that returns the same array after running the callback.