CKTIS / JavaScript
String.prototype.endsWith — kontrola konca reťazca
String.prototype.endsWith kontroluje, či sa reťazec končí zadaným textom, a vracia true alebo false. Rozlišuje veľké a malé písmená, reťazec nemení a umožňuje určiť skoršiu koncovú hranicu kontroly.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
str.endsWith(searchString[, endPosition])String.prototype.endsWith porovnáva searchString s koncom reťazca a vracia true alebo false bez zmeny pôvodného reťazca. Pri porovnaní rozlišuje veľké a malé písmená a pracuje s UTF-16 kódovými jednotkami, bez normalizácie Unicode. Je to metóda štandardnej knižnice ECMAScript, nie API prehliadača.
Voliteľný parameter endPosition určuje výhradnú koncovú hranicu: metóda kontroluje koniec prefixu po túto hranicu, nie podreťazec, ktorý sa na tomto mieste začína. Ak argument vynecháte alebo odovzdáte undefined, použije sa celá dĺžka. Po prevode na celé číslo sa hodnota obmedzí na rozsah od 0 po dĺžku reťazca; záporné hodnoty nepočítajú od konca dozadu. Pozície sa merajú v UTF-16 kódových jednotkách.
Ak je searchString prázdny, metóda vracia true aj pri hranici 0, pokiaľ prípadný prevod endPosition prebehne úspešne. Prevod prebieha pred porovnaním: odovzdanie 0n ako hodnoty endPosition spôsobí TypeError aj pri prázdnom searchString. Argument searchString sa prevádza na reťazec, takže ak ho vynecháte, použije sa text "undefined". Argument rozpoznaný ako regulárny výraz spôsobí TypeError. TypeError spôsobí aj volanie metódy s hodnotou this rovnou null alebo undefined.
V príklade je hranica 10 hneď za report.txt, takže kontrola .txt vráti true, hoci sa celý reťazec končí na .bak. Kontrola .BAK vráti false, pretože sa líši veľkosť písmen.
Príklady
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));Výsledok
true true false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.