String.prototype.includes
Проверяет, содержит ли строка заданную подстроку.
Доступно с: ES2015
Синтаксис
str.includes(searchString, position)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| searchString | string | Подстрока, которую нужно найти. |
| position | number | Необязательный. С какой позиции начинать поиск; по умолчанию 0. |
Возвращаемое значение
boolean`true`, если подстрока найдена, иначе `false`.
Примеры
Подстрока есть и подстроки нет:
console.log('Hello, world'.includes('world'));
console.log('Hello, world'.includes('JS'));Результат:
true
falseПоиск учитывает регистр:
console.log('Hello'.includes('hello'));Результат:
falseПримечания
Чтобы искать без учёта регистра, приведите обе строки к одному регистру через toLowerCase().
См. также
- String.prototype.startsWith — Проверяет, начинается ли строка с заданной подстроки.
- String.prototype.indexOf — Находит позицию первого вхождения подстроки.
- String.prototype.endsWith — Проверяет, заканчивается ли строка заданным текстом.
- RegExp.prototype.test — Проверяет, есть ли в строке совпадение с шаблоном.
Вопросы и ответы по теме
В учебнике
- Методы строк — Полезные методы строк в JavaScript: поиск позиции, доступ к символам, padStart, repeat, split и join, цепочки методов.