Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje