JavaScript Array.prototype.find() 메서드 완벽 가이드

JavaScript Array.prototype.find() 메서드란?

Array.prototype.find() 메서드는 배열에서 주어진 조건을 만족하는 첫 번째 요소의 값을 반환합니다. 조건에 맞는 요소가 여러 개 있더라도 가장 먼저 발견된 하나만 반환하며, 만족하는 요소가 없으면 undefined를 리턴합니다.

콜백 함수는 배열의 각 요소에 대해 순서대로 실행되며, 콜백이 true를 반환하는 순간 탐색이 중단되고 해당 요소가 결과로 돌아옵니다.

주요 특징

조건을 만족하는 첫 번째 요소의 값만 반환합니다.
조건에 일치하는 요소가 없으면 undefined를 반환합니다.
원본 배열은 변경되지 않습니다.

예제 코드

다음은 Array.prototype.find() 메서드의 동작을 보여주는 전체 예제입니다.

<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
<style>
    body {
        font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
    }
    .find {
        font-size: 20px;
        font-weight: 500;
    }
</style>
</head>
<body>
<h1>JavaScript Array find() 예제</h1>
<div class="find"></div>
<button class="fillArr">CLICK HERE</button>
<h3>위 버튼을 클릭하면 동물 목록에서 사자(lion)를 찾습니다</h3>
<script>
    function findLion(animal) {
        return animal === "lion";
    }
    let fillEle = document.querySelector(".find");
    let arr = ["cow", "lion", "bull", "tiger"];
    fillEle.innerHTML = arr;
    document.querySelector(".fillArr").addEventListener("click", () => {
        fillEle.innerHTML = arr.find(findLion);
    });
</script>
</body>
</html>

실행 결과

위 코드를 실행하면 다음과 같은 화면이 출력됩니다.

JavaScript Array.prototype.find() 메서드 완벽 가이드

페이지가 로드되면 ["cow", "lion", "bull", "tiger"] 배열 전체가 화면에 표시됩니다. 이후 “CLICK HERE” 버튼을 클릭하면 find() 메서드가 실행되어 조건(요소가 "lion"과 일치)을 만족하는 첫 번째 요소인 lion만 화면에 나타납니다.

JavaScript Array.prototype.find() 메서드 완벽 가이드

코드 설명

findLion() 함수는 각 동물 이름이 "lion"과 같은지 확인하는 콜백 함수입니다.
arr.find(findLion)는 배열을 처음부터 순회하며 콜백이 참을 반환하는 첫 번째 요소를 찾습니다.
버튼 클릭 이벤트가 발생하면 검색 결과가 .find div 영역에 출력됩니다.