Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.match — dopasowania wyrażenia regularnego

Metoda match() wyszukuje dopasowania wyrażenia regularnego w tekście. Flaga g zmienia kształt wyniku: bez niej otrzymujesz co najwyżej jedno dopasowanie wraz z grupami przechwytującymi, a z nią — tablicę pełnych dopasowań. Brak dopasowania daje null.

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

string.match(regexp)

String.prototype.match służy do wyszukiwania dopasowań wzorca w tekście bez zmieniania tekstu. Dla standardowego obiektu RegExp wynikiem jest tablica albo null, gdy nic nie pasuje. Przed odczytem elementów wyniku sprawdź, czy nie jest on null.

Bez flag g i y metoda zwraca pierwsze dopasowanie, jeśli je znajdzie. Z flagą y, ale bez g, metoda próbuje dopasować wzorzec dokładnie od pozycji uzyskanej po przekształceniu bieżącej wartości lastIndex za pomocą operacji ToLength. Na przykład /a/y z lastIndex ustawionym na -1 znajduje w tekście 'a' dopasowanie pod indeksem 0. Metoda może więc zwrócić późniejsze dopasowanie albo null, nawet jeśli wzorzec pasuje w innym miejscu tekstu. Gdy bez flagi g uda się znaleźć dopasowanie, element 0 zawiera całość, a kolejne elementy — grupy przechwytujące. Właściwość index wskazuje pozycję dopasowania w jednostkach kodowych UTF-16, a input zawiera przeszukiwany tekst. Z flagą g tablica zawiera pełne, niepokrywające się dopasowania, ale nie zawiera grup ani tych metadanych. Bez flagi y wyszukiwanie może przechodzić dalej mimo przerw między dopasowaniami. Z obiema flagami, g i y, wyszukiwanie kończy się, gdy wzorzec nie pasuje w bieżącej pozycji. Dlatego 'a a'.match(/a/gy) zwraca tylko ['a'], mimo że drugie a znajduje się pod indeksem 2. Aby zachować grupy dla wielu dopasowań, użyj matchAll().

Argument tekstowy jest interpretowany jako wzorzec wyrażenia regularnego, a nie dosłowny tekst: "abc".match(".")[0] daje "a". Pominięcie argumentu lub przekazanie undefined tworzy pusty wzorzec, więc wynikiem jest dopasowanie pustego tekstu, nie null.

Technicznie metoda deleguje działanie do Symbol.match, jeśli argument udostępnia taką metodę. Własna implementacja może więc zwrócić inny typ wyniku; opis tablic powyżej dotyczy standardowego działania RegExp.

Przykłady

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Wynik

["item-12","12",0]
["item-12","item-34"]
null

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

Źródła