Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.startsWith — sprawdzanie początku tekstu

Metoda startsWith sprawdza, czy tekst zawiera podany prefiks na początku lub dokładnie na wskazanej pozycji. Zwraca wartość logiczną, rozróżnia wielkość liter i nie zmienia tekstu.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

string.startsWith(searchString[, position])

String.prototype.startsWith zwraca true, gdy searchString pasuje dokładnie od indeksu position; w przeciwnym razie zwraca false. Nie szuka dopasowania na dalszych pozycjach i nie zmienia tekstu.

Domyślne position to 0. Wartość jest konwertowana na liczbę całkowitą przez obcięcie części ułamkowej w kierunku zera, a następnie ograniczana do zakresu od 0 do długości tekstu; NaN oznacza 0. Indeksy liczą jednostki kodowe UTF-16, niekoniecznie całe znaki widoczne dla użytkownika.

Porównanie rozróżnia wielkość liter i nie normalizuje Unicode. Pusty searchString daje true, także gdy podana pozycja przekracza długość tekstu. Inne wartości są konwertowane na tekst: pominięty argument oznacza wyszukiwanie "undefined". Zwykłe wyrażenie regularne powoduje TypeError.

Metoda może działać na innych odbiorcach przez call, konwertując je na tekst, ale odbiorca null lub undefined powoduje TypeError. To API języka ECMAScript, nie DOM; sama specyfikacja nie potwierdza obsługi w konkretnej przeglądarce.

Przykłady

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));

Wynik

true
false
true
false
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła