CKTIS / JavaScript
String.prototype.startsWith — preverjanje predpone niza
Metoda startsWith preveri, ali ima niz določeno predpono na začetku ali natančno na navedeni poziciji. Vrne logično vrednost, razlikuje med velikimi in malimi črkami ter niza ne spremeni.
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
string.startsWith(searchString[, position])String.prototype.startsWith vrne true, kadar se searchString natančno ujema pri indeksu position; sicer vrne false. Ne išče ujemanja na poznejših pozicijah in niza ne spremeni.
Privzeta vrednost za position je 0. Vrednost se pretvori v celo število tako, da se njen ulomljeni del odreže proti nič, nato pa se omeji na razpon od 0 do dolžine niza; NaN pomeni 0. Indeksi štejejo kodne enote UTF-16, ki ne ustrezajo nujno celotnim znakom, kot jih zaznava uporabnik.
Primerjava razlikuje med velikimi in malimi črkami ter ne normalizira Unicode. Prazen searchString vrne true, tudi če navedena pozicija presega dolžino niza. Druge vrednosti se pretvorijo v nize: če argument izpustimo, se išče "undefined". Običajni regularni izraz povzroči TypeError.
Metoda lahko prek call deluje tudi z drugimi prejemniki in jih pri tem pretvori v nize, vendar prejemnik null ali undefined povzroči TypeError. To je jezikovni API ECMAScript, ne API DOM; sama specifikacija ne potrjuje podpore v določenem brskalniku.
Primeri
const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));Rezultat
true false 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.