Skip to content

indexOf

INFO

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

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

배열에서 주어진 요소가 첫 번째로 일치하는 인덱스를 찾아요.

Array.prototype.indexOf와 거의 같게 동작하는데요, NaN 값을 찾을 수 있어요. NaN이 아닌 요소를 비교할 때는 엄격 동등 연산(===)을 사용해요.

인터페이스

typescript
function indexOf<T>(array: T[], searchElement: T, fromIndex?: number): number;

파라미터

  • array (T[]): 검색할 배열.

arrayArrayLike<T>이거나 null 또는 undefined일 수 있어요

lodash와 완전히 호환되도록 indexOf 함수는 array를 다음과 같이 처리해요.

  • arrayArrayLike<T>인 경우, 배열로 변환하기 위해 Array.from(...)을 사용해요.
  • arraynull 또는 undefined인 경우, 빈 배열로 간주돼요.
  • searchElement (T): 찾을 값.
  • fromIndex (number, 선택): 검색을 시작할 인덱스.

반환 값

(number): 배열에서 주어진 값과 첫 번째로 일치하는 요소의 인덱스. 일치하는 요소를 찾을 수 없으면 -1을 반환해요.

예시

typescript
const array = [1, 2, 3, NaN];
indexOf(array, 3); // => 2
indexOf(array, NaN); // => 3

MIT 라이선스에 따라 배포됩니다.