Метод includes()

Array.includes()

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

Спецификация: 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. Если вычисленный индекс меньше нуля, то поиск будет производиться во всём массиве: