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.