Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.endsWith — kontrola konce řetězce

String.prototype.endsWith kontroluje, zda řetězec končí zadaným textem, a vrací true nebo false. Rozlišuje velká a malá písmena, řetězec nemění a umožňuje pro kontrolu určit dřívější koncovou hranici.

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

Syntaxe

str.endsWith(searchString[, endPosition])

String.prototype.endsWith porovnává searchString s koncem řetězce a vrací true nebo false, aniž by původní řetězec měnila. Při porovnání rozlišuje velká a malá písmena a pracuje s UTF-16 kódovými jednotkami, bez normalizace Unicode. Jde o metodu standardní knihovny ECMAScript, nikoli o API prohlížeče.

Volitelný parametr endPosition určuje výhradní koncovou hranici: metoda kontroluje konec prefixu končícího na této hranici, nikoli podřetězec, který tam začíná. Pokud argument vynecháte nebo předáte undefined, použije se celá délka. Po převodu na celé číslo se hodnota omezí na rozsah od 0 do délky řetězce; záporné hodnoty nepočítají zpět od konce. Pozice se měří v UTF-16 kódových jednotkách.

Je-li searchString prázdný, metoda vrací true i na hranici 0, pokud případný převod endPosition proběhne úspěšně. Převod probíhá před porovnáním: předání 0n jako hodnoty endPosition způsobí TypeError i při prázdném searchString. Argument searchString se převádí na řetězec, takže pokud jej vynecháte, použije se text "undefined". Argument rozpoznaný jako regulární výraz způsobí TypeError. TypeError způsobí také volání metody s hodnotou this rovnou null nebo undefined.

V příkladu leží hranice 10 hned za report.txt, takže kontrola .txt vrátí true, přestože celý řetězec končí na .bak. Kontrola .BAK vrátí false, protože se liší velikost písmen.

Pří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ýsledek

true
true
false
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje