forEach

INFO

이 함수는 호환성을 위한 es-toolkit/compat 에서만 가져올 수 있어요. 대체할 수 있는 네이티브 JavaScript API가 있거나, 아직 충분히 최적화되지 않았기 때문이에요.

es-toolkit/compat에서 이 함수를 가져오면, lodash와 완전히 똑같이 동작해요.

배열 (arr)의 요소들을 왼쪽에서 오른쪽으로 순회하며 각 요소에 대해 callback 함수를 호출해요.

callback 함수가 false를 반환하면 순회를 멈춰요.

인터페이스

function forEach<T extends object>(object: T, callback: (value: T[keyof T], key: keyof T, object: T) => void): T;

파라미터

• object (T): 순회할 객체. 배열, 문자열, 또는 객체일 수 있어요.
• callback ((value: T[keyof T], key: T, object: T)): 각 반복마다 호출될 함수.
  • value: 배열에서 처리 중인 현재 요소.
  • index: 배열에서 처리 중인 현재 요소의 프로퍼티 이름.
  • object: forEach 함수가 호출된 객체.

반환 값

(T): forEach로 순회하는 객체.

예시

import { forEach } from 'es-toolkit/array';

const array = [1, 2, 3];
const result: number[] = [];

// forEach 함수를 사용하여 배열을 순회하며 각 요소를 결과 배열에 추가해요.
forEach(array, value => {
  result.push(value);
});

console.log(result); // Output: [3, 2, 1];