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

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

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

Чтобы определить, совпадает ли конец данной строки с указанной строкой, или символом, Вы можете воспользоваться методом endsWith().

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

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

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

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

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

JavaScript синтаксис

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

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

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

ECMAScript: String.prototype.startsWith()

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

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

Пустая искомая строка даёт true при любой допустимой позиции. Другие значения преобразуются в строки; без первого аргумента ищется "undefined".

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

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

Начало строки и позиция поиска

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

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.startsWith('H')) // true
console.log(myString.startsWith('Hello')) // true
console.log(myString.startsWith('hello')) // false
console.log(myString.startsWith('ello')) // false

console.log(myString.startsWith('world')) // false
console.log(myString.startsWith('Hello', -100)) // true (поиск с начала строки)
console.log(myString.startsWith('world', 1)) // false
console.log(myString.startsWith('world', 6)) // true