Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

RegExp.prototype.test — sprawdzanie dopasowania

Metoda test() sprawdza, czy wyrażenie regularne pasuje do tekstu, i zwraca true albo false. Flagi g i y powodują używanie lastIndex, więc kolejne wywołania mogą dawać różne wyniki.

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

Składnia

regexp.test(string)

RegExp.prototype.test wywołujesz jako regexp.test(string). Zwraca true, gdy znajdzie dopasowanie, lub false, gdy go nie ma. Nie zwraca przechwyconych grup; do tego służy exec(). Argument jest konwertowany na tekst, a pominięty argument staje się tekstem "undefined".

Domyślnie wystarcza dopasowanie fragmentu tekstu. Aby ograniczyć dopasowanie do granic wejścia, użyj kotwic ^ i $, pamiętając, że flaga m zmienia je w granice wierszy.

Przy standardowym exec() flagi g i y używają lastIndex do ustalenia pozycji początkowej. Z flagą g wyszukiwanie może przejść na dalsze pozycje, ale flaga y na to nie pozwala. W trybie Unicode (z flagą u lub v), jeśli lastIndex wskazuje młodszy surogat pary surogatów UTF-16, dopasowanie może zacząć się od poprzedzającego go starszego surogatu, nawet z flagą y. Sukces ustawia lastIndex na koniec dopasowania, a porażka zeruje je. Bez obu tych flag standardowe exec() nadal odczytuje lastIndex i stosuje do odczytanej wartości operację ToLength. Jeśli ta operacja się powiedzie, wyszukiwanie zaczyna się od pozycji 0, a właściwość lastIndex nie jest aktualizowana. Jeśli jednak przypiszesz do lastIndex wartość typu Symbol, test() zgłosi wyjątek TypeError nawet bez g i y. Do niezależnych sprawdzeń pomiń g i y albo ustaw lastIndex = 0 przed każdym wywołaniem.

Dopasowanie pustego tekstu nie przesuwa automatycznie lastIndex: pętla oparta na test() może się nie zakończyć. Metoda korzysta z exec(), więc jego nadpisanie może zmienić zachowanie. To API języka ECMAScript, nie API przeglądarki.

Przykłady

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"));

Wynik

true
3
false
0
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła