String.prototype.startsWith()

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

Попробовать

const str = "Saturday night plans";

console.log(str.startsWith("Sat"));
// Expected output: true

console.log(str.startsWith("Sat", 3));
// Expected output: false

Синтаксис

startsWith(searchString)
startsWith(searchString, position)

Параметры

searchString

Символы, которые нужно искать в начале этой строки. Не может быть регулярным выражением. Все значения, которые не являются регулярными выражениями, преобразуются в строки, поэтому пропуск или передача undefined приводит к тому, что startsWith() ищет строку "undefined", что редко является желаемым результатом.

position Необязательно

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

Возвращаемое значение

true если заданные символы найдены в начале строки, в том числе, когда searchString является пустой строкой; в противном случае, false.

Исключения

TypeError

Выбрасывается, если searchString является регулярным выражением.

Описание

Этот метод позволяет определить, начинается ли строка с другой строки. Этот метод чувствителен к регистру.

Примеры

Использование startsWith()

const str = "To be, or not to be, that is the question.";

console.log(str.startsWith("To be")); // true
console.log(str.startsWith("not to be")); // false
console.log(str.startsWith("not to be", 10)); // true

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

Совместимость с браузерами

Смотрите также

• Полифил String.prototype.startsWith в core-js
• Полифил es-shims String.prototype.startsWith
• String.prototype.endsWith()
• String.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()