JavaScript includes(), 다양한 예제

JavaScript에서 배열에 어떤 값이 들어있는지 확인할 때 includes()를 사용할 수 있습니다. includes()의 사용 방법을 알아보고 다양한 예제를 소개합니다.

1. includes(valueToFind) : 배열에 어떤 값이 있는지 확인

arr.includes(valueToFind)는 인자로 전달된 값이 배열에 포함되어있다면 true를 리턴하며 그렇지 않으면 false를 리턴합니다.

아래와 같이 배열에 어떤 값이 포함되어있는지 확인할 수 있습니다.

const array1 = [1, 2, 3];

console.log(array1.includes(2));
console.log(array1.includes(3));
console.log(array1.includes(4));

Output:

true
true
false

Number 뿐만 아니라, String 배열도 includes()를 사용하여 확인할 수 있습니다. 문자열이 다르거나, 대소문자가 달라도 다른 문자로 인식하여 false를 리턴합니다.

const pets = ['cat', 'dog', 'bat'];

console.log(pets.includes('cat'));
console.log(pets.includes('at'));
console.log(pets.includes('dog'));
console.log(pets.includes('Dog'));

Output:

true
false
true
false

2. includes(valueToFind, fromIndex) : 특정 인덱스 값 이상에서 어떤 값이 있는지 확인

includes(valueToFind, fromIndex)는 배열의 fromIndex를 포함하고 이상의 Index에서 어떤 값이 포함되어 있다면 true를 리턴하고 그렇지 않으면 false를 리턴합니다. 즉, 배열에 해당 값이 있어도 범위를 지정한 Index 보다 아래에 있으면 false가 리턴됩니다.

const array1 = [1, 2, 3];

console.log(array1.includes(2, 0));
console.log(array1.includes(2, 1));

console.log(array1.includes(1, 2));
console.log(array1.includes(2, 2));
console.log(array1.includes(3, 2));

Output:

true
true
false
false
true

3. fromIndex가 배열 범위를 벗어난 숫자일 때

범위를 지정하는 fromIndex 인자가 배열 범위를 벗어난 숫자일 때 어떻게 동작할까요?

• fromIndex가 음수인 경우 0으로 취급되며, 배열의 전체에서 검색됩니다.
• fromIndex가 배열의 길이보다 같거나 큰 경우는 false를 리턴합니다. 이 때는 배열을 검색하지 않습니다.

const array1 = [1, 2, 3];

console.log(array1.includes(2, -100));
console.log(array1.includes(2, 100));

Output:

true
false