String.includes() — запустить онлайн

String

String.includes()

Проверяет, содержит ли строка заданную подстроку

→ booleanPHP: str_contains()ES7+

stringstring

Исходная строка

searchStringstring

Искомая подстрока

positionnumberнеобязательный

Начальная позиция

(string).includes(searchString, position)

РЕЗУЛЬТАТ

— нажмите Выполнить или Ctrl+Enter —

Справочник параметров

Параметр	Тип	Статус	Описание
string	string	required	Исходная строка
searchString	string	required	Искомая подстрока
position	number	optional	Начальная позиция

О функции

includes() возвращает true если строка содержит указанную подстроку, иначе false. Более читаемая альтернатива indexOf() !== -1. Регистрозависим. Аналогичные методы: startsWith() для начала строки, endsWith() для конца.

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

Появился в ES7/ES2016. PHP получил str_contains() только в PHP 8.0 (2020). До ES2016 использовали indexOf() !== -1.

Советы и подводные камни

includes() регистрозависим — для регистронезависимой проверки: str.toLowerCase().includes(sub.toLowerCase())
для паттернов используйте test()
includes() не принимает RegExp.