Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

String.prototype.endsWith — preverjanje konca niza

String.prototype.endsWith preveri, ali se niz konča z določenim besedilom, in vrne true ali false. Razlikuje med velikimi in malimi črkami, niza ne spremeni ter omogoča določitev zgodnejše končne meje preverjanja.

Različica: 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 primerja searchString s koncem niza in vrne true ali false, ne da bi spremenila izvirnik. Pri primerjavi razlikuje med velikimi in malimi črkami ter uporablja kodne enote UTF-16, brez normalizacije Unicode. To je metoda standardne knjižnice ECMAScript, ne API brskalnika.

Izbirni parameter endPosition določa izključno končno mejo: metoda preveri konec predpone do te meje, ne pa podniza, ki se tam začne. Če argument izpustite ali podate undefined, se uporabi celotna dolžina. Po pretvorbi v celo število se vrednost omeji na razpon od 0 do dolžine niza; negativne vrednosti ne štejejo nazaj od konca. Položaji se merijo v kodnih enotah UTF-16.

Če je searchString prazen, metoda vrne true tudi pri meji 0, če je morebitna pretvorba endPosition uspešna. Pretvorba se izvede pred primerjavo: če kot endPosition podate 0n, se sproži TypeError, tudi če je searchString prazen. Argument searchString se pretvori v niz, zato se ob njegovi opustitvi uporabi besedilo "undefined". Argument, prepoznan kot regularni izraz, povzroči TypeError. Tudi klic metode, pri katerem je this enak null ali undefined, povzroči TypeError.

V primeru je meja 10 takoj za report.txt, zato preverjanje .txt vrne true, čeprav se celoten niz konča z .bak. Preverjanje .BAK vrne false, ker se velike in male črke razlikujejo.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri