CKTIS / JavaScript
RegExp.prototype.exec — dopasowanie i grupy przechwytujące
RegExp.prototype.exec wyszukuje dopasowanie i zwraca tablicę z dopasowanym tekstem oraz grupami albo null. Flagi g i y sprawiają, że kolejne wywołania korzystają z lastIndex i zmieniają jego wartość.
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.exec(string)regexp.exec(string) wykonuje dopasowanie wyrażenia regularnego. Argument jest konwertowany na tekst; wbudowana metoda wymaga rzeczywistej instancji RegExp jako this. Wynikiem jest tablica albo null, nie wartość logiczna. Sprawdź wynik przed odczytem jego właściwości.
match[0] zawiera całe dopasowanie, a match[1] i następne elementy — grupy przechwytujące; grupa, która nie uczestniczyła w dopasowaniu, daje undefined. match.index to pozycja początku w jednostkach kodowych UTF-16, a match.input to przeszukiwany tekst. match.groups zawiera nazwane grupy albo undefined, jeśli wzorzec ich nie ma. Flaga d dodatkowo udostępnia match.indices z parami początku i końca; koniec jest wyłączny.
Bez g i y wyszukiwanie zaczyna się od pozycji 0 i nie zmienia lastIndex. Jeśli ustawiono g lub y, punktem wyjścia wyszukiwania jest wartość lastIndex po zastosowaniu operacji ToLength (na przykład 1.9 daje 1). Z g, ale bez y, po nieudanej próbie wyszukiwanie może przejść dalej; z y nie sprawdza późniejszych pozycji. W trybie Unicode (u lub v), jeśli przeliczona wartość lastIndex wskazuje drugi element pary surogatów UTF-16, dopasowanie może zacząć się na pierwszym elemencie tej pary. Dlatego nawet z y zwracane match.index nie musi być równe przeliczonej wartości lastIndex. Sukces ustawia lastIndex na koniec dopasowania, a niepowodzenie zeruje go. Przed ponownym użyciem takiego obiektu do niezależnego wyszukiwania ustaw lastIndex = 0.
W pętli zachowaj ten sam obiekt RegExp. Uwaga: dopasowanie pustego tekstu nie przesuwa automatycznie lastIndex; bez jawnego przesunięcia lub przerwania pętla może się nie zakończyć. Przykład używa wzorca, który zawsze dopasowuje co najmniej jeden znak, i pokazuje wyzerowanie po końcowym niepowodzeniu.
Przykłady
const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);Wynik
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.