String.prototype.includes()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Методincludes() значенийString проверяет с учётом регистра, содержит ли строка заданную подстроку, и возвращает, соответственноtrue илиfalse.

Интерактивный пример

const sentence = "The quick brown fox jumps over the lazy dog.";const word = "fox";console.log(  `The word "${word}" ${    sentence.includes(word) ? "is" : "is not"  } in the sentence`,);// Expected output: "The word "fox" is in the sentence"

Синтаксис

includes(searchString)includes(searchString, position)

Параметры

searchString: Подстрока для поиска. Не может бытьрегулярным выражением. Все значения, не являющиеся регулярными выражениями,приводятся к строкам, поэтому при отсутствии параметра или передаче значенияundefined методincludes() будет искать подстроку"undefined", что редко бывает полезно.
positionНеобязательный: Позиция, с которой начинается поискsearchString. (По умолчанию0.)

Возвращаемое значение

true, если искомая подстрока была найдена в данной строке (в том числе когдаsearchString является пустой строкой), иfalse в противном случае.

Исключения

TypeError: Возникает еслиsearchStringявляется регулярным выражением.

Описание

Этот метод позволяет определять, содержит ли строка другую строку.

Чувствительность к регистру символов

Методincludes() является регистрозависимым. Например, следующее выражение вернётfalse:

"Синий кит".includes("синий"); // false

Для обхода этого ограничения можно преобразовать обе строки в нижний регистр:

"Синий кит".toLowerCase().includes("синий"); // true

Примеры

Использование`includes()`

const str = "Быть или не быть, вот в чём вопрос.";console.log(str.includes("Быть")); // trueconsole.log(str.includes("вопрос")); // trueconsole.log(str.includes("Гамлет")); // falseconsole.log(str.includes("Быть", 1)); // falseconsole.log(str.includes("БЫТЬ")); // falseconsole.log(str.includes("")); // true