Кратко
СкопированоЭтот метод определён у массивов и строк.
Для массивов: проверяет, есть ли искомый элемент в массиве.
Для строк: проверяет, есть ли искомая подстрока в строке.
Возвращает true
, если искомый элемент нашёлся, и false
— если нет 😎
Пример
СкопированоМетод принимает два аргумента — значение, которое нужно проверить, и позицию, начиная с которой необходимо проверять. Второй аргумент необязательный, он равен 0
по умолчанию.
Особенности использования второго аргумента
СкопированоЕсли передать в качестве аргумента положительное значение или 0
, поиск начнётся с этого индекса и до конца массива.
Если передать отрицательное значение, поиск начнётся с этого индекса, отсчитанного от конца массива, и будет происходить до конца массива. Для этого случая индекс начала поиска можно рассчитать по формуле длина массива
. Например, длина массива/строки — 10
, переданный аргумент — -2
. Начало поиска с позиции — 8
, так как 10 +
.
Если второй аргумент больше длины массива/строки, то метод всегда будет возвращать false
.
Массив:
const dead = ['Джон Сноу', 'Джофри', 'Нед Старк', 'Король ночи']const isAryaDead = dead.includes('Арья Старк')console.log(isAryaDead)// falseconst isJoffreyDead = dead.includes('Джофри')console.log(isJoffreyDead)// trueconst isJohnDead = dead.includes('Джон Сноу', 1)console.log(isJohnDead)// false
const dead = ['Джон Сноу', 'Джофри', 'Нед Старк', 'Король ночи'] const isAryaDead = dead.includes('Арья Старк') console.log(isAryaDead) // false const isJoffreyDead = dead.includes('Джофри') console.log(isJoffreyDead) // true const isJohnDead = dead.includes('Джон Сноу', 1) console.log(isJohnDead) // false
Строка:
const text = 'Посмотри, ведь это рядом наша панда. Мы бежим с тобой как-будто от гепарда.'console.log(text.includes('панда'))// trueconsole.log(text.includes('Обезьяна'))// false// Поиск идёт с учётом регистраconsole.log(text.includes('Панда'))// false
const text = 'Посмотри, ведь это рядом наша панда. Мы бежим с тобой как-будто от гепарда.' console.log(text.includes('панда')) // true console.log(text.includes('Обезьяна')) // false // Поиск идёт с учётом регистра console.log(text.includes('Панда')) // false
На практике
Скопированосоветует Скопировано
🛠 Используйте метод, когда нужно убедиться в том, что объект находится в массиве. Например, чтобы не добавить одно и то же значение дважды.
🛠 Будьте внимательны при передаче объектов в includes
. Если два объекта выглядят одинаково, это не обязательно один объект, потому что объекты хранятся по ссылке.
const phoneContacts = [ { name: 'Иван', lastName: 'Таранов' }, { name: 'Игорь', lastName: 'Иванов' }, { name: 'Мама', lastName: '' },]console.log(phoneContacts.includes( { name: 'Мама', lastName: '' }))// false
const phoneContacts = [ { name: 'Иван', lastName: 'Таранов' }, { name: 'Игорь', lastName: 'Иванов' }, { name: 'Мама', lastName: '' }, ] console.log(phoneContacts.includes( { name: 'Мама', lastName: '' } )) // false
Здесь console
выведет false
, так как мы создали новый объект, хотя он выглядит так же как и тот, что в массиве.