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.