База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

String.prototype.startsWith — проверка на префикс на низ

Методът startsWith проверява дали даден низ има посочения префикс в началото или точно на зададена позиция. Връща булева стойност, различава главни и малки букви и не променя низа.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

string.startsWith(searchString[, position])

String.prototype.startsWith връща true, когато searchString съвпада точно на индекс position; в противен случай връща false. Методът не търси съвпадение на по-късни позиции и не променя низа.

Стойността по подразбиране на position е 0. Стойността се преобразува в цяло число чрез отрязване на дробната част към нулата, след което се ограничава в диапазона от 0 до дължината на низа; NaN означава 0. Индексите броят UTF-16 кодови единици, които не винаги съответстват на цели знаци, възприемани от потребителя.

Сравнението различава главни и малки букви и не нормализира Unicode. Празен searchString връща true, дори когато зададената позиция надвишава дължината на низа. Останалите стойности се преобразуват в низове: ако аргументът бъде пропуснат, се търси "undefined". Обикновен регулярен израз причинява TypeError.

Методът може да работи и с други приемници чрез call, като ги преобразува в низове, но приемник null или undefined причинява TypeError. Това е API на езика ECMAScript, а не DOM API; самата спецификация не доказва поддръжка в конкретен браузър.

Примери

const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));

Резултат

true
false
true
false
true

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

Източници