String.prototype.includes()
Baseline Widely 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("Быть")); // true console.log(str.includes("вопрос")); // true console.log(str.includes("Гамлет")); // false console.log(str.includes("Быть", 1)); // false console.log(str.includes("БЫТЬ")); // false console.log(str.includes("")); // true Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.includes |
