CKTIS / JavaScript
String.prototype.endsWith — provjera završetka niza
String.prototype.endsWith provjerava završava li niz zadanim tekstom i vraća true ili false. Razlikuje velika i mala slova, ne mijenja niz i omogućuje određivanje ranije završne granice za provjeru.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
str.endsWith(searchString[, endPosition])String.prototype.endsWith uspoređuje searchString sa završetkom niza i vraća true ili false bez promjene izvornika. Usporedba razlikuje velika i mala slova te radi s UTF-16 kodnim jedinicama, bez Unicode normalizacije. To je metoda standardne biblioteke ECMAScript, a ne API preglednika.
Neobavezni parametar endPosition postavlja isključivu završnu granicu: metoda provjerava završetak prefiksa do te granice, a ne podniz koji ondje počinje. Ako se argument izostavi ili se preda undefined, koristi se puna duljina. Nakon pretvorbe u cijeli broj vrijednost se ograničava na raspon od 0 do duljine niza; negativne vrijednosti ne broje unatrag od kraja. Pozicije se mjere u UTF-16 kodnim jedinicama.
Ako je searchString prazan, metoda vraća true čak i na granici 0, pod uvjetom da pretvorba argumenta endPosition, ako je potrebna, uspije. Pretvorba se provodi prije usporedbe: prosljeđivanje vrijednosti 0n kao argumenta endPosition uzrokuje TypeError čak i ako je searchString prazan. Argument searchString pretvara se u niz, pa se pri njegovu izostavljanju koristi tekst "undefined". Argument prepoznat kao regularni izraz uzrokuje TypeError. TypeError uzrokuje i poziv metode s vrijednošću this jednakom null ili undefined.
U primjeru je granica 10 odmah nakon report.txt, pa provjera .txt vraća true iako cijeli niz završava s .bak. Provjera .BAK vraća false zbog razlike između velikih i malih slova.
Primjeri
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));Rezultat
true true false true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.