본문 바로가기
IT 개발

[JavaScript] 자바스크립트 includes

by Angela- 2025. 1. 18.

 

배열에서 includes() 함수

배열에 특정 요소가 포함하는지 확인하는 함수입니다.
배열에서 주어진 요소가 포함되어 있으면 true를 그렇지 않으면 false를 반환합니다

찾는 요소가 문자열일 경우 대소문자를 구분합니다.
찾는 요소가 문자열일 경우 주어진 문자열과 일치해야만 true를 반환합니다.
그렇지 않고 특정 부분만 일치하면 false를 반환합니다.


구문

arr.includes(searchElement[, fromIndex])


arr은 includes() 함수를 적용할 배열입니다.
searchElement - 배열에서 찾을 요소입니다.
fromIndex - 옵션. 검색을 시작할 인덱스이며, 생략하면 기본값으로 0이 사용됩니다.
         만약 음수 값을 가진다면, 배열의 끝에서부터 역순으로 검색을 시작합니다.

 

const words = ["apple", "banana", "orange"];

console.log(words.includes("apple")); 
// true
console.log(words.includes("Apple")); 
// false
console.log(words.includes("ban")); 
// false

 

includes() 함수의 다양한 활용 사례

 

● 변수 포함 확인

const fruit = "My fruit";
const words = ["apple", "banana", fruit];

console.log(words.includes(fruit)); 
// true
console.log(words.includes("My fruit")); 
// true

 

 

● 희소 배열

const arr = [1, , 3];

console.log(arr.includes(undefined));
// true

희소 배열에서 undefined를 검색하면 true를 반환합니다.

 

 

● NaN 비교

console.log(NaN === NaN);
// false

const values = [1, NaN, 3, 4, 5];
console.log(values.includes(NaN)); 
// true

 

자바스크립트에서 NaN는 자신과 동등하지 않습니다. 즉, NaN === NaN은 항상 false입니다.


하지만 배열에서는 includes() 함수를 사용하여 배열에 NaN이 포함되어 있는지 확인할 수 있습니다.
이것은 유용하게 활용할 수 있는 부분입니다.