Array.prototype.includes
Проверяет, есть ли значение в массиве.
Доступно с: ES2016
Синтаксис
array.includes(searchElement, fromIndex)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| searchElement | any | Искомое значение. |
| fromIndex | number | Необязательный. С какого индекса начинать поиск. |
Возвращаемое значение
boolean`true`, если значение найдено, иначе `false`.
Примеры
Поиск значения:
console.log(['a', 'b', 'c'].includes('b'));
console.log(['a', 'b', 'c'].includes('z'));Результат:
true
falseСравнение строгое: строка '1' не равна числу 1:
console.log([1, 2, 3].includes('1'));Результат:
falseПримечания
Объекты сравниваются по ссылке, поэтому найти объект с такими же свойствами метод не сможет — для этого нужен some() или find().
См. также
- Array.prototype.find — Возвращает первый элемент, прошедший проверку.
- Array.prototype.some — Проверяет, проходит ли проверку хотя бы один элемент.
- Array.prototype.indexOf — Ищет значение в массиве и возвращает его индекс.
- Set.prototype.has — Проверяет, есть ли значение в Set.
Вопросы и ответы по теме
В учебнике
- Поиск в массиве — Как найти элемент в массиве JavaScript: includes, indexOf, find, findIndex, some и every.