JavaScript метод String.prototype.includes()

Определение и применение

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

Пустая искомая строка всегда найдена. Обычное регулярное выражение вместо строки вызывает TypeError. Остальные значения преобразуются в строки; пропущенный аргумент означает поиск "undefined".

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2016 года.

Показать браузеры
Совместимостьjavascript.builtins.String.includes
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
includes✓41✓12✓40

Версия 40 выпущена в 2015 г.

Версия 18 выпущена в 2013 г. — Удалено в 48; Имя contains

✓28✓9✓41✓40

Версия 40 выпущена в 2015 г.

Версия 18 выпущена в 2013 г. — Удалено в 48; Имя contains

✓28✓9✓4.0✓41✓9

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
// поиск осуществляется с начала строки
str.includes( searchString );

// поиск осуществляется с определенного индекса
str.includes( searchString, index );

Спецификация

ECMAScript: String.prototype.includes()

Значения параметров

String: справочные сведения
Параметр Описание
searchString Искомая строка, или символ. Обязательный параметр.
index Позиция в строке, с которой будет происходить поиск (значение по умолчанию 0). Необязательный параметр. При указании отрицательного значения поиск осуществляется с начала строки.

Примеры, попробуйте сами

В примере «Поиск подстроки с позиции» показан результат вызова метода.

Поиск подстроки с позиции

Измените исходную строку или аргумент метода и сравните результат после запуска.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Поиск подстроки с позиции</title>
  </head>
  <body>
    <p>Результат выполнения выводится в консоль.</p>
  </body>
</html>
main.js
JavaScript
var myString = 'Hello world' // инициализируем строковую переменную

console.log(myString.includes('H')) // true
console.log(myString.includes('ll')) // true
console.log(myString.includes('h')) // false

console.log(myString.includes('H', -100)) // true
console.log(myString.includes('orl', 7)) // true
console.log(myString.includes('orl', 8)) // false