Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

RegExp.prototype.test — ověření shody

Metoda test() ověřuje, zda regulární výraz odpovídá textu, a vrací true nebo false. Příznaky g a y způsobují, že vyhledávání používá lastIndex, takže opakovaná volání mohou vracet různé výsledky.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.test(string)

RegExp.prototype.test voláš jako regexp.test(string). Pokud najde shodu, vrátí true, jinak vrátí false. Zachycené skupiny nevrací; k jejich získání použij exec(). Argument se převede na text. Pokud argument vynecháš, stane se jím text "undefined".

Ve výchozím nastavení stačí, aby odpovídala část textu. Chceš-li shodu omezit na hranice vstupu, použij kotvy ^ a $; pamatuj, že příznak m z nich udělá hranice řádků.

U standardní implementace exec() se s příznakem g i s příznakem y počáteční pozice určuje podle lastIndex. S příznakem g může vyhledávání zkoušet další pozice, s příznakem y se na ně neposouvá. Pokud v režimu Unicode (s příznakem u nebo v) ukazuje lastIndex na dolní člen zástupného páru UTF-16, shoda může začít u předchozího horního členu tohoto páru, a to i s příznakem y. Při úspěchu se lastIndex nastaví na konec shody, při neúspěchu se vrátí na nulu. I když není nastaven ani jeden z těchto příznaků, standardní implementace exec() přečte lastIndex a na jeho hodnotu použije operaci ToLength. Pokud se převod podaří, vyhledávání začne na pozici 0, aniž by se vlastnost lastIndex změnila. Pokud ale do lastIndex přiřadíš hodnotu typu Symbol, test() vyvolá výjimku TypeError i bez příznaků g a y. Chceš-li provádět nezávislá ověření, vynech g a y nebo před každým voláním nastav lastIndex = 0.

Prázdná shoda automaticky neposune lastIndex: cyklus založený na test() nemusí skončit. Metoda používá exec(), takže její přepsání může změnit chování. Jde o API jazyka ECMAScript, nikoli o API prohlížeče.

Pří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ýsledek

true
3
false
0
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje