Метод includes() массива 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 в JavaScript