[JS - 개념] Includes()

 

 

Array.prototype.includes() 

 

 

includes 메서드는 배열이 특정 요소를 포함하고 있는지 판별합니다. 

 

 

반환값은 Boolean 입니다. 

 

 

구문 

 

arr.includes(valueToFind[, fromIndex])

 

 

const array1 = [1, 2, 3];

console.log(array1.includes(2));
// expected output: true

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

console.log(pets.includes('cat'));
// expected output: true

console.log(pets.includes('at'));
// expected output: false

 

 

[1, 2, 3].includes(2);     // true
[1, 2, 3].includes(4);     // false
[1, 2, 3].includes(3, 3);  // false
[1, 2, 3].includes(3, -1); // true
[1, 2, NaN].includes(NaN); // true

 

 

 

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

 

fromIndex 가 배열의 길이보다 같거나 크다면, false를 반환합니다.  

배열은 검색되지 않을 것 입니다. 

var arr = ['a', 'b', 'c'];

arr.includes('c', 3);   // false
arr.includes('c', 100); // false

 

 

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

 

// array length is 3
// fromIndex is -100
// computed index is 3 + (-100) = -97

var arr = ['a', 'b', 'c'];

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