Array.prototype.findLastIndex()

Baseline 2022

Newly available

Since August 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

findLastIndex() 메서드는 배열을 역순으로 순회하며 주어진 판별 함수를 만족하는 만족하는 배열의 첫번째 요소의 인덱스를 반환합니다. 만족하는 요소가 없으면 -1을 반환합니다.

인덱스 대신 판별함수를 만족하는 마지막 값을 반환하는findLast()메서드도 참고하세요.

시도해보기

구문

js
findLastIndex(callbackFn)
findLastIndex(callbackFn, thisArg)

매개변수

callbackFn

배열의 각 요소에 대해 실행할 함수입니다. 이 함수는 매칭된 요소가 발견되었음을 나타내기 위해 참 값을 반환해야하며, 그렇지 않으면 거짓 값을 반환해야 합니다. 이 함수는 다음과 같은 인수와 함께 호출됩니다.

element

배열에서 처리중인 현재 요소입니다.

index

배열에서 처리중인 현재 요소의 인덱스입니다.

array

findLastIndex()가 호출된 배열입니다.

thisArg Optional

callbackFn을 실행할 때 this로 사용할 객체입니다. 자세한 내용은 반복적인 메소드(iterative methods)를 참조합니다.

반환 값

테스트를 통과하는 배열에서 마지막 요소(가장 높은 인덱스)의 인덱스입니다. 만약 매칭되는 요소가 없다면 -1을 반환합니다.

설명

findLastIndex() 메서드는 반복적인 메소드(iterative methods)입니다. 이 메서드는 배열의 각 요소마다 제공된 callbackFn 함수를 역순으로 한 번씩 호출하며, callbackFn참 값을 반환할 때까지 반복합니다. 참 값이 반환되면 findLastIndex()는 해당 요소의 인덱스를 반환하고 배열 반복을 중단합니다. 만약 callbackFn이 참 값을 반환하지 않으면, findLastIndex()-1을 반환합니다.

callbackFn는 배열의 모든 인덱스에 대해 호출됩니다. 할당된 값이 있는 인덱스뿐만 아니라 희소 배열(sparse arrays)의 비어있는 슬롯도 undefined와 동일하게 동작합니다.

findLastIndex() 메서드는 호출된 배열을 변경하지 않지만, 인자로 제공된 callbackFn은 변경할 수 있습니다. 그러나, 배열의 길이는 callbackFn의 첫 호출 이전에 저장됨에 유의합니다. 따라서 다음과 같이 동작합니다.

  • callbackFnfindLastIndex()가 호출된 이후 배열에 추가된 요소에 방문하지 않습니다.
  • 이미 방문한 인덱스의 변경은 callbackFn을 다시 호출하지 않습니다.
  • callbackFn에 의해 아직 방문되지 않은 배열의 기존 요소가 변경되면, callbackFn에 전달되는 값은 해당 요소가 방문되었을 때의 값이 됩니다. 삭제된 (en-US) 요소는 마치 undefined인 것처럼 방문됩니다.

경고: 위에서 설명한 종류의 동시 수정은 이해하기 어려운 코드로 이어지는 경우가 많으며, 일반적으로 피해야 할 것입니다 (특별한 경우를 제외하고).

findLastIndex() 메서드는 일반적인(generic) 메서드입니다. 이는 this 값이 length 속성과 정수 키 속성을 가지고 있는 것만을 요구합니다.

예제

배열에서 마지막 소수의 인덱스 찾기

다음 예제는 배열에서 마지막으로 나오는 소수(prime number)의 인덱스를 반환하며, 소수가 없는 경우 -1을 반환합니다.

js
function isPrime(element) {
  if (element % 2 === 0 || element < 2) {
    return false;
  }
  for (let factor = 3; factor <= Math.sqrt(element); factor += 2) {
    if (element % factor === 0) {
      return false;
    }
  }
  return true;
}

console.log([4, 6, 8, 12].findLastIndex(isPrime)); // -1, not found
console.log([4, 5, 7, 8, 9, 11, 12].findLastIndex(isPrime)); // 5

희소 배열에서 findLastIndex() 사용

희소 배열에서 undefined를 찾아 빈 슬롯의 인덱스를 알아낼 수 있습니다.

js
console.log([1, , 3].findLastIndex((x) => x === undefined)); // 1

배열이 아닌 객체에서 findLastIndex() 사용

findLastIndex() 메서드는 thislength 속성을 읽은 다음 각 정수 인덱스에 접근합니다.

js
const arrayLike = {
  length: 3,
  0: 2,
  1: 7.3,
  2: 4,
};
console.log(
  Array.prototype.findLastIndex.call(arrayLike, (x) => Number.isInteger(x)),
); // 2

명세

Specification
ECMAScript Language Specification
# sec-array.prototype.findlastindex

브라우저 호환성

BCD tables only load in the browser

같이 보기