JavaScript метод includes()ECMAScript 2015

JavaScript String

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

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


Обращаю Ваше внимание, что метод includes()ECMAScript 2015 является регистрозависимым.


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

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
includes()ECMAScript 201541.040.0*28.09.0НетДа

JavaScript синтаксис:

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

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

Версия JavaScript

ECMAScript 2015 (6th Edition, ECMA-262)

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

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

Пример использования

var myString = "Hello world"; // инициализируем cтроковую переменную

myString.includes( "H" ); // true
myString.includes( "ll" ); // true
myString.includes( "h" ); // false

myString.includes( "H", -100 ); // true
myString.includes( "orl", 7 ); // true
myString.includes( "orl", 8 ); // false
JavaScript String