자바스크립트 배열 findIndex() 함수 – 콜백 함수의 조건에 맞는 첫 번째 요소의 인덱스 찾기

정의 및 사용 방법

findIndex() 함수는 주어진 배열에서 콜백 함수의 조건을 만족하는 첫 번째 요소의 인덱스를 반환합니다.
조건에 맞는 요소가 없으면 -1을 반환합니다.

배열에서 인덱스는 0부터 시작합니다.

사용법을 시각화하면 다음과 같습니다.

[😃, 🏀, 🍎, 🍇, 🐵].findIndex(function(찾는_요소) {
    return 찾는_요소 === 과일;
}); // 👉 2

// 이 배열에서 찾는 요소의 조건인 과일(🍎, 🍇) 중
// 첫 번째 과일(🍎)의 **인덱스(2)**가 반환됩니다.

findIndex() 함수는 배열에서 특정한 조건을 만족하는 첫 번째 요소의 인덱스를 찾을 때 유용합니다.

특징

조건은 콜백 함수에서 적용합니다.
- 조건을 만족하면 true, 만족하지 않으면 false를 반환하도록 작성합니다.
조건에 맞는 요소가 여러 개 있어도, 첫 번째로 일치하는 요소의 인덱스만 반환됩니다.
이러한 동작으로 원본 배열은 변경되지 않고 그대로 유지됩니다.

기본 예제

아래 예제에서는 배열에서 조건을 만족하는 첫 번째 요소의 인덱스를 findInex() 함수로 찾는 방법을 보여줍니다. 각 단계별로 주석을 통해 동작을 설명합니다.

JavaScript

// 배열을 생성합니다.
const numbers = [1, 3, 7, 4, 6, 8];

// 조건(짝수)을 만족하는 첫 번째 요소의 인덱스를 찾습니다.
const firstEvenIndex = numbers.findIndex(function(num) {
    return num % 2 === 0; // 짝수인지 확인
});

// 결과를 출력합니다.
// 조건(짝수)을 만족하는 첫 번째 요소는 4이고,
// 해당 요소의 인덱스는 3입니다.
console.log(firstEvenIndex); // 출력: 3

참고하세요!
배열의 findLastIndex() 함수는 주어진 배열에서 콜백 함수의 조건을 만족하는 마지막 요소의 인덱스를 반환합니다.

참고하세요!
배열의 find() 함수는 주어진 배열에서 콜백 함수의 조건을 만족하는 첫 번째 요소를 반환합니다.

구문

arr은 findIndex() 함수를 적용할 배열입니다.

매개변수

findIndex() 함수의 매개변수 설명
`callbackFn`	배열의 각 요소를 처리하는 콜백 함수입니다. 콜백 함수는 배열의 각 요소에 대해 실행됩니다. 콜백 함수는 주어진 요소에 대해 실행되고, 콜백 함수 내에서 정의한 조건을 확인합니다. 조건은 `return` 문을 사용하여 정의되며, 조건이 `true`로 평가되면 해당 요소를 찾은 것으로 간주됩니다. `findIndex()` 함수는 조건을 만족하는 첫 번째 요소를 찾으면 배열 순회를 중단하고 해당 요소의 인덱스를 반환합니다. 그러면 코드 실행이 멈춥니다. 콜백 함수의 매개변수: `callbackFn(element[, index[, array]])` `element`: 현재 처리 중인 배열 요소 `index`: 옵션. 현재 처리 중인 배열 요소의 인덱스 `array`: 옵션. `findIndex()`를 호출한 배열 자체
`thisArg`	옵션. `callbackFn` 함수 내부에서 사용할 `this` 값으로 사용할 값입니다.

첫 번째 매개변수인 콜백 함수(callbackFn)과 관련되어 함수의 형태별 구문 형식은 다음과 같습니다.

JavaScript

// 화살표 함수
findIndex((element) => { /* … */ })
findIndex((element[, index]) => { /* … */ })
findIndex((element[, index[, array]]) => { /* … */ })

// 콜백 함수
findIndex(callbackFn)
findIndex(callbackFn[, thisArg])

// 인라인 콜백 함수
findIndex(function (element) { /* … */ })
findIndex(function (element[, index]) { /* … */ })
findIndex(function (element[, index[, array]]) { /* … */ })
findIndex(function (element[, index[, array]]) { /* … */ }[, thisArg])

반환 값

콜백 함수가 찾아낸 첫 번째 조건을 만족하는 배열 요소의 인덱스입니다.
만약 조건을 만족하는 요소를 찾지 못했다면 -1을 반환합니다.

콜백 함수의 작동 원리

findIndex() 함수는 주어진 배열의 요소를 개발자가 직접 작성한 콜백 함수를 사용하여 원하는 조건에 따라 찾고, 조건을 충족하는 첫 번째 요소의 인덱스를 반환하는 함수입니다.

findIndex() 함수의 콜백 함수는 배열의 요소들 중에서 콜백 함수 내에서 정의한 조건을 확인합니다. 조건은 return 문을 사용하여 정의되며, 조건이 true로 평가되면 해당 요소를 찾은 것으로 간주됩니다. findIndex() 함수는 조건을 만족하는 첫 번째 요소를 찾으면 배열 순회를 중단하고 해당 요소의 인덱스를 반환합니다. 그러면 코드 실행이 멈춥니다.

JavaScript findIndex() 함수에서 사용하는 콜백 함수의 구조

/**
 * 콜백 함수
 *
 * @param {*} element 배열의 각 요소
 * @param {number} index 배열의 인덱스 (선택적)
 * @param {Array} array 원본 배열 (선택적)
 * @return {boolean} 필터링 조건을 충족하면 true, 그렇지 않으면 false 반환
 *
 * 콜백 함수는 기명 함수(사용자 정의 함수)나 익명 함수 등으로 사용할 수 있습니다.
 * (당연히) 모든 콜백 함수는 화살표 함수로 사용할 수 있습니다.
 */

/* 콜백 함수를 기명 함수를 사용할 경우 */
function callbackFn(element[, index[, array]]) { // 기명 함수 정의
	// return 문을 사용하여 조건을 정의합니다.
}

arr.findIndex(callbackFn); // 정의한 기명 함수명을 매개변수에 직접 전달

/* 콜백 함수를 익명 함수로 사용할 경우 */
arr.findIndex(function (element[, index[, array]]) {
    // return 문을 사용하여 조건을 정의합니다.
});

다양한 활용 사례

findIndex() 함수는 배열에서 특정 조건을 만족하는 첫 번째 요소의 인덱스를 찾는데 사용되며, 다양한 활용 사례가 있습니다. 특히 특정 값 위치 찾기에 유용합니다. 몇 가지 예시를 살펴보겠습니다.

배열에 특정 요소의 존재 유무 확인

배열에서 조건을 만족하는 요소가 존재하는지 확인할 때 사용할 수 있습니다.

JavaScript

// 배열에 특정 요소의 존재 유무 확인
// 배열에서 조건을 만족하는 요소의 인덱스를 이용해
// 존재 여부를 판별할 수 있습니다.

const numbers = [1, 2, 3, 4, 5];
const target = 3;

// 조건을 만족하는 첫 번째 요소의 인덱스를 찾습니다.
const index = numbers.findIndex(element => element === target);

// 결과에 따라 메시지를 출력합니다.
if (index !== -1) {
    console.log(`찾는 값(${target})이 배열에 존재합니다. 인덱스: ${index}`);
} else {
    console.log(`찾는 값(${target})이 배열에 존재하지 않습니다.`);
}

// 출력: 찾는 값(3)이 배열에 존재합니다. 인덱스: 2

특정 유저의 첫 로그인 기록 찾기

이번 예제에서는 사용자 로그인 기록 배열에서 특정 유저의 첫 로그인 기록을 찾는 방법을 살펴봅니다.

JavaScript

// 사용자 로그인 기록 배열
const loginHistory = [
  { user: 'Alice', date: '2025-01-01' },
  { user: 'Bob', date: '2025-01-02' },
  { user: 'Alice', date: '2025-01-05' },
  { user: 'Charlie', date: '2025-01-06' },
  { user: 'Alice', date: '2025-01-10' },
  { user: 'Bob', date: '2025-01-12' },
];

// 특정 사용자
const targetUser = 'Alice';

// 첫 로그인(findIndex)
const firstLoginIndex = loginHistory.findIndex(record => record.user === targetUser);

if (firstLoginIndex !== -1) {
  const firstLogin = loginHistory[firstLoginIndex];
  console.log(`첫 로그인:
    - 사용자: ${firstLogin.user}
    - 날짜: ${firstLogin.date}`);
} else {
  console.log(`${targetUser}의 첫 로그인 기록이 없습니다.`);
}

/* 출력:
첫 로그인:
    - 사용자: Alice
    - 날짜: 2025-01-01
*/

findIndex() 함수를 사용하면 배열에서 조건에 맞는 첫 번째 요소의 인덱스를 효과적으로 찾을 수 있으므로, 다양한 상황에서 유용하게 활용할 수 있습니다.