[ Javascript ] Array.prototype.includes()

includes() 메서드

includes() 메서드는 배열이 특정 요소를 포함하고 있는지 확인합니다.

 

구문

arr.includes(valueTofind[, fromIndex]);

 

매개변수

• valueToFind: 탐색할 요소입니다. ( 문자, 문자열을 비교할 때 includes() 메서드는 대소문자를 구분합니다. )
• fromIndex: 이 배열에서 searchElement 검색을 시작할 위치입니다. 음의 값일 경우 array.length + fromIndex의 인덱스를 ASC( Ascending )로 검색합니다. 기본값은 0입니다.

 

반환 값

Boolean값입니다.

 

예제

있는지 없는지 확인하기

const arr = [1, 2, 3];

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

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

console.log(pets.includes("cat")); // true
console.log(pets.includes("c")); // false

 

fromIndex가 배열의 길이와 같거나 길이보다 큰 경우

const arr = ["a", "b", "c"];

console.log(arr.includes("c", 1)); // true
console.log(arr.includes("c", 2)); // true

// C가 대문자입니다.
console.log(arr.includes("C", 2)); // false
// fromIndex가 배열의 길이와 같습니다.
console.log(arr.includes("c", 3)); // false

 

0보다 작은 인덱스의 계산

fromIndex가 음수일 때, 인덱스는 valueToFind를 찾기 시작할 배열의 위치로 사용되기 위해 연산됩니다. 만약 계산된 인덱스가 -1 * array.length보다 작거나 같으면 배열이 검색됩니다.

const arr = ["a", "b", "c"];

console.log(arr.includes("a", -100)); // true
console.log(arr.includes("b", -100)); // true
console.log(arr.includes("c", -100)); // true
console.log(arr.includes("a", -2)); // false
console.log(arr.includes("b", -2)); // true
console.log(arr.includes("c", -2)); // true

arr 배열의 길이는 3입니다. 

3 + ( -100 ) = -97

3 + ( -2 ) = 1