CKTIS / JavaScript
RegExp.prototype.test — overenie zhody
Metóda test() overuje, či regulárny výraz zodpovedá textu, a vracia true alebo false. Príznaky g a y spôsobujú, že vyhľadávanie používa lastIndex, takže opakované volania môžu vracať rôzne výsledky.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
regexp.test(string)RegExp.prototype.test voláš ako regexp.test(string). Ak nájde zhodu, vráti true, inak vráti false. Zachytené skupiny nevracia; na ich získanie použi exec(). Argument sa skonvertuje na text. Ak argument vynecháš, stane sa ním text "undefined".
V predvolenom nastavení stačí, aby zodpovedala časť textu. Ak chceš zhodu obmedziť na hranice vstupu, použi kotvy ^ a $; pamätaj, že príznak m z nich urobí hranice riadkov.
Pri štandardnej implementácii exec() sa s príznakom g aj s príznakom y počiatočná pozícia určuje podľa lastIndex. S príznakom g môže vyhľadávanie skúšať aj ďalšie pozície, s príznakom y sa na ne neposúva. Ak v režime Unicode (s príznakom u alebo v) ukazuje lastIndex na dolný člen náhradného páru UTF-16, zhoda sa môže začať na predchádzajúcom hornom člene tohto páru, a to aj s príznakom y. Pri úspechu sa lastIndex nastaví na koniec zhody, pri neúspechu sa vynuluje. Aj keď nie je nastavený ani jeden z týchto príznakov, štandardná implementácia exec() prečíta lastIndex a na jeho hodnotu použije operáciu ToLength. Ak sa konverzia podarí, vyhľadávanie sa začne na pozícii 0 bez zmeny vlastnosti lastIndex. Ak však do lastIndex priradíš hodnotu typu Symbol, test() vyvolá výnimku TypeError aj bez príznakov g a y. Ak chceš vykonávať nezávislé kontroly, vynechaj g a y alebo pred každým volaním nastav lastIndex = 0.
Prázdna zhoda automaticky neposunie lastIndex: cyklus založený na test() sa nemusí skončiť. Metóda používa exec(), takže jej prepísanie môže zmeniť správanie. Ide o API jazyka ECMAScript, nie o API prehliadača.
Príklady
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"));Výsledok
true 3 false 0 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.