String.prototype.startsWith()

Метод startsWith() (починається з підрядка) значень String визначає, чи починається його рядок символами з рядка-параметра, повертаючи true або false відповідно.

Спробуйте його в дії

Синтаксис

startsWith(searchString)
startsWith(searchString, position)

Параметри

searchString

Символи, які слід шукати на початку цього рядка. Не може бути регулярним виразом. Будь-яке значення, що не є регулярним виразом, зводиться до рядка, тож пропуск цього параметра або передача в ньому undefined змушує startsWith() шукати рядок "undefined", а це рідко саме те, що потрібно.

position Необов'язкове

Стартова позиція, на якій очікується знайти searchString (індекс першого символу searchString). Усталено — 0.

Повернене значення

Значення true, якщо дані символи знайдені на початку рядка, включно з випадком, коли searchString є порожнім рядком; інакше – false.

Винятки

TypeError

Викидається, коли searchString є регулярним виразом.

Опис

Цей метод дає змогу визначити, чи рядок починається іншим рядком. Також він чутливий до регістру символів.

Приклади

Застосування startsWith()

const str = "Чи бути, чи не бути — ось питання.";

console.log(str.startsWith("Чи бути")); // true
console.log(str.startsWith("не бути")); // false
console.log(str.startsWith("не бути", 12)); // true

Специфікації

Сумісність із браузерами

Дивіться також

• Поліфіл методу String.prototype.startsWith доступний у core-js
• String.prototype.endsWith()
• String.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()