Вебсправочник
Справочник JavaScript

String.includes(): поиск подстроки

Метод includes проверяет наличие подстроки и возвращает логическое значение без позиции совпадения.

Назначение

Метод includes проверяет наличие подстроки и возвращает логическое значение без позиции совпадения.

Как это работает

Поиск чувствителен к регистру. Второй аргумент задаёт начальную позицию. Для поиска без учёта регистра часто нормализуют обе строки, учитывая языковые правила конкретной задачи.

Пример

const title='Изучаем HTML';
console.assert(title.includes('HTML'));
console.assert(!title.includes('html'));
console.assert(title.toLowerCase().includes('html'));

Что должно получиться

Точное совпадение регистра найдено, другой регистр не найден. Нормализация строки позволяет выполнить простую нечувствительную проверку для этого учебного примера.

Граница применения и частая ошибка

Поиск подстроки не является проверкой безопасного адреса или домена. Строка может содержать разрешённое имя в другой части URL, поэтому адреса нужно разбирать структурно.

Самостоятельная проверка

Сравните поиск HTML и html в одной строке. Затем найдите совпадение после заданной позиции и объясните, зачем обе стороны приводят к согласованному регистру.

JavaScript в песочнице этого сайта не выполняется. Перенесите пример в отдельный учебный файл. Сначала проверьте исходный результат, затем измените входные данные; ошибка проверки означает, что результат отличается от ожидаемого.

Самостоятельный учебный материал. Техническая документация: первоисточник по теме ↗. Если результат отличается, проверьте код и версию браузера.