Метод includes() массива JavaScript

Array 对象参考手册Объект Array в JavaScript

Пример

Проверить массивsiteна наличие example:

let site = ['example', 'google', 'taobao']; site.includes('example'); // true site.includes('baidu'); // false

Попробуйте сами »

Определение и использование

Метод includes() используется для определения, содержит ли массив указанное значение. Если да, возвращает true; в противном случае возвращает 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

Поддержка браузеров

Числа в таблице указывают первую версию браузера, которая поддерживает метод.

Метод
includes() 47 14 43 9 34

Синтаксис

arr.includes(searchElement)
arr.includes(searchElement, fromIndex)

Описание параметра

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

Технические детали

Возвращаемое значение: Boolean. Возвращает true, если указанное значение найдено, иначе возвращает false.
Версия JavaScript: ECMAScript 6

Другие примеры

fromIndex больше или равен длине массива

Если fromIndex больше или равен длине массива, возвращается false. Массив не будет просматриваться:

Пример

var arr = ['a', 'b', 'c']; arr.includes('c', 3); //false arr.includes('c', 100); // false

Вычисленный индекс меньше 0

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

Пример

//Длина массива равна 3 //fromIndex равен -100 //вычисленный индекс равен 3 + (-100) = -97 var arr = ['a', 'b', 'c']; arr.includes('a', -100); // true arr.includes('b', -100); // true arr.includes('c', -100); // true

Array 对象参考手册Объект Array в JavaScript

Другие расширения