JavaScript Array find()

정의와 사용법

find() 메서드는 테스트를 통과한 첫 번째 배열 요소의 값을 반환합니다（함수로 제공됩니다）。

find() 메서드는 배열에 존재하는 각 요소에 대해 함수를 한 번 실행합니다：

  • find() 함수의 값을 true로 반환하는 배열 요소를 찾으면, find() 함수는 해당 배열 요소의 값을 반환합니다（그 이후의 값을 확인하지 않습니다）
  • 그렇지 않으면 undefined을 반환합니다

주석:find() 비어 있는 배열에 대한 함수를 실행하지 마세요。

주석:find() 원래 배열을 변경하지 않습니다。

예제

예제 1

배열에서 첫 번째 값이 18 또는 그 이상인 요소의 값을 가져오세요：

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

직접 테스트해 보세요

예제 2

배열에서 특정 숫자보다 큰 첫 번째 요소의 값을 가져옵니다:

<p>최소 연령: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">시도해 보세요</button>
<p>18세 이상의 어떤 연령도: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
</script>

직접 테스트해 보세요

문법

array.find(function(currentValue, index, arr}), thisValue)

매개 변수 값

매개 변수 설명
function(currentValue, index, arr) 필수. 배열의 각 요소에 대해 실행되는 함수

함수 매개 변수:

매개 변수 설명
currentValue 필수. 현재 요소의 값
index 선택 사항. 현재 요소의 배열 인덱스
arr 선택 사항. 현재 요소가 속한 배열 객체
thisValue

선택 사항. 함수의 "this" 값으로 사용할 값으로 전달합니다.

이 参数가 비어 있으면, 값 "undefined"이 "this" 값으로 전달됩니다.

기술 세부 사항

반환 값: 배열의 어떤 요소도 테스트를 통과하면 해당 배열 요소 값이 반환되며, 그렇지 않으면 undefined가 반환됩니다.
JavaScript 버전: ECMAScript 6

브라우저 지원

표에 수록된 숫자는 이 방법을 최초로 완전히 지원하는 브라우저 버전을 나타냅니다.

크롬 에지 파이어폭스 사파리 오페라
크롬 45 에지 12 파이어폭스 25 사파리 7.1 오페라 32
2015년 9월 2015년 7월 2014년 7월 2014년 9월 2015년 9월

주석:인터넷 익스플로어가 지원하지 않습니다 find() 메서드。

관련 페이지

教程：JavaScript 배열

教程：JavaScript 배열 Const

教程：JavaScript 배열 메서드

教程：JavaScript 배열 정렬

教程：JavaScript 배열 반복