Определяет, содержит ли массив указанный элемент.

Спецификация: ECMAScript 2015 (6th Edition, ECMA-262)
array.includes(searchElement, fromIndex)

Параметры

searchElement
Искомый элемент.
fromIndex
Необязательный параметр. Позиция в массиве, с которой начинать поиск элемента searchElement. Если атрибут опущен, то поиск осуществляется с 0 индекса.
Допускается использование отрицательных значений, в этом случае поиск производится начиная с индекса array.length - fromIndex по возрастанию.

Логическое значение true или false в зависимости от того содержит ли массив искомый элемент.

Метод includes() определяет, содержит ли массив определённый элемент, возвращая в зависимости от этого true или false.

Примечание: Если второй аргмент метода fromIndex больше или равен длине массиве, то возвращается false. При этом поиск не производится.

В следующем примере метод find используется для того, чтобы найти нечетное число в массиве:

Выполнить код »

На заметку: Если вы ищете внутри массива NaN (Not a number - не число), независимо от наличия возвращаемое значение метода indexOf() будет -1, а метод метод includes() определеяет фактическое наличие.

Если аргумент fromIndex отрицательный, как в следующем примере, то вычисляется индекс, начиная с которого будет производиться поиск элемента searchElement. Если вычисленный индекс меньше нуля, то поиск будет производиться во всём массиве:

Выполнить код »

Комментарии

пожелания к комментариям…
  • Приветствуются комментарии, соответствующие теме урока: вопросы, ответы, предложения.
  • Одну строчку кода оборачивайте в тег <code>, несколько строчек кода — в теги <pre><code>...ваш код...</code></pre>.
  • Допускаются ссылки на онлайн-песочницы (codepen, plnkr, JSBin и др.).