CKTIS / JavaScript
String.prototype.endsWith — sprawdzanie końcówki napisu
String.prototype.endsWith sprawdza, czy napis kończy się wskazanym tekstem, i zwraca true albo false. Rozróżnia wielkość liter, nie zmienia napisu i pozwala wskazać wcześniejszy koniec sprawdzanego fragmentu.
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
str.endsWith(searchString[, endPosition])String.prototype.endsWith porównuje searchString z końcówką napisu i zwraca true albo false, nie zmieniając oryginału. Porównanie rozróżnia wielkość liter i działa na jednostkach kodowych UTF-16, bez normalizacji Unicode. To metoda standardowej biblioteki ECMAScript, a nie API przeglądarki.
Opcjonalny endPosition wyznacza wyłączną granicę końca: sprawdzana jest końcówka fragmentu od początku napisu do tej granicy, nie fragment zaczynający się w tym miejscu. Pominięcie argumentu lub undefined oznacza pełną długość. Po konwersji do liczby całkowitej wartość jest ograniczana do zakresu od 0 do długości napisu; ujemne wartości nie liczą od końca. Pozycje są mierzone w jednostkach kodowych UTF-16.
Pusty searchString daje true także przy granicy 0, o ile ewentualna konwersja endPosition się powiedzie. Konwersja następuje przed sprawdzeniem dopasowania: przekazanie 0n jako endPosition powoduje TypeError nawet przy pustym searchString. Argument searchString jest konwertowany na napis, więc jego pominięcie oznacza tekst "undefined". Argument rozpoznany jako wyrażenie regularne powoduje TypeError. Wywołanie metody z this równym null lub undefined również powoduje TypeError.
W przykładzie granica 10 przypada tuż po report.txt, dlatego sprawdzenie .txt daje true, mimo że cały napis kończy się na .bak. Sprawdzenie .BAK daje false ze względu na wielkość liter.
Przykłady
const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));Wynik
true true false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.