CKTIS / JavaScript
RegExp.prototype.test — preverjanje ujemanja
Metoda test() preveri, ali se regularni izraz ujema z besedilom, in vrne true ali false. Zastavici g in y povzročita, da iskanje uporablja lastIndex, zato lahko ponovljeni klici dajo različne rezultate.
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
regexp.test(string)RegExp.prototype.test pokličeš kot regexp.test(string). Če najde ujemanje, vrne true, sicer vrne false. Zajetih skupin ne vrne; za njihovo pridobitev uporabi exec(). Argument se pretvori v besedilo. Če argument izpustiš, postane besedilo "undefined".
Privzeto zadostuje, da se ujema del besedila. Če želiš ujemanje omejiti na meje vhoda, uporabi sidri ^ in $; upoštevaj, da ju zastavica m spremeni v meji vrstic.
Pri standardni izvedbi exec() zastavici g in y za določitev začetnega položaja uporabljata lastIndex. Z zastavico g lahko iskanje preveri tudi poznejše položaje, z zastavico y pa ne. Če v načinu Unicode (z zastavico u ali v) lastIndex kaže na nizki nadomestni znak nadomestnega para UTF-16, se lahko ujemanje začne pri predhodnem visokem nadomestnem znaku, tudi z zastavico y. Ob uspehu se lastIndex nastavi na konec ujemanja, ob neuspehu pa se ponastavi na nič. Tudi če ni nastavljena nobena od teh zastavic, standardna izvedba exec() prebere lastIndex in nad prebrano vrednostjo izvede operacijo ToLength. Če pretvorba uspe, se iskanje začne na položaju 0, ne da bi se lastnost lastIndex spremenila. Če pa lastnosti lastIndex prirediš vrednost tipa Symbol, test() sproži izjemo TypeError tudi brez zastavic g in y. Za neodvisna preverjanja izpusti g in y ali pred vsakim klicem nastavi lastIndex = 0.
Prazno ujemanje samodejno ne poveča vrednosti lastIndex: zanka, ki temelji na test(), se morda ne bo končala. Metoda uporablja exec(), zato lahko prepis te metode spremeni vedenje. To je API jezika ECMAScript, ne API brskalnika.
Primeri
const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));Rezultat
true 3 false 0 true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.