CKTIS / JavaScript
Nazwane grupy przechwytujące RegExp i podstawienia w tekście zastępczym
Naucz się odczytywać fragmenty dopasowania po nazwie i wstawiać je do wyniku za pomocą tekstu zastępczego lub funkcji.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
/(?<name>pattern)/
/(?<name>pattern)\k<name>/
regexp.exec(text)?.groups?.name
text.replace(regexp, "$<name>")
text.replace(regexp, replacer)
text.replaceAll(globalRegexp, replacement)
Replacement string tokens: $$, $&, $`, $', $1 … $99, $<name>(?<name>...) przechwytuje tekst pasujący do podwzorca. Grupy nazwane i nienazwane są numerowane wspólnie od 1, według kolejności nawiasów otwierających; (?:...) nie przechwytuje. Po udanym exec() odczytasz wartość przez result.groups.name; jeśli grupa nie uczestniczyła w dopasowaniu, wartość to undefined. \k<name> to odwołanie wsteczne we wzorcu, które służy do dopasowania przechwyconego tekstu, a nie do jego wstawiania w wyniku zamiany.
W tekście zastępczym $<name> wstawia wartość grupy nazwanej, $1 pierwszej grupy, $& całe dopasowanie, $$ znak dolara, a $` i $' odpowiednio tekst przed i po dopasowaniu w oryginale. Gdy wzorzec ma grupy nazwane, brakująca nazwa lub grupa, która nie uczestniczyła w dopasowaniu, daje pusty ciąg. Bez grup nazwanych $<name> pozostaje dosłowne. Istniejąca grupa numerowana, która nie uczestniczyła w dopasowaniu, też daje pusty ciąg; jeśli $12 nie ma grupy 12, może oznaczać $1 i dosłowne 2, o ile grupa 1 istnieje.
Funkcja zastępująca otrzymuje całe dopasowanie, wartości grup w kolejności, pozycję w jednostkach kodowych UTF-16, wejściowy ciąg i — tylko gdy wzorzec ma grupy nazwane — obiekt groups. Grupy nieuczestniczące mają wartość undefined. Wynik funkcji nie jest ponownie interpretowany jako szablon: użyj () => text, by wstawić tekst zawierający $ dosłownie.
Dla zwykłego RegExp metoda replace() bez flag g i y zastępuje tylko pierwsze dopasowanie, a z g bez y zastępuje wszystkie. Z y bez g zastępuje co najwyżej jedno dopasowanie, które musi zaczynać się na bieżącej pozycji lastIndex. Z gy zaczyna od pozycji 0 i kończy działanie, gdy na bieżącej pozycji nie ma dopasowania, bez szukania dalej. replaceAll() z wyrażeniem regularnym bez g zgłasza TypeError. Obie metody zwracają ciąg wynikowy bez zmiany wejścia.
Nazwa grupy musi mieć składnię identyfikatora. Nieprawidłowa nazwa powoduje SyntaxError, podobnie jak każda powtórzona nazwa w ECMAScript 2024. ECMAScript 2025 dopuszcza powtórzenie nazwy w odrębnych gałęziach tej samej alternatywy |. Sprawdź obsługę w docelowym środowisku; dla zgodności z ECMAScript 2024 używaj unikalnych nazw.
Przykłady
const text = "AB-12 CD";
const token = /(?<code>[A-Z]{2})(?:-(?<number>\d+))?/g;
console.log(text.replace(token, "[$<code>:$<number>]"));
console.log(text.replace(token, (match, code, number, offset, input, groups) =>
`[${groups.code}:${groups.number ?? "none"}]`
));Wynik
[AB:12] [CD:] [AB:12] [CD:none]
Dla `CD` grupa `number` nie uczestniczy w dopasowaniu. Tekst zastępczy pozostawia pole puste, a funkcja wstawia `none`.
Powiązane lekcje
- JavaScript · Lekcja 25 · Średniozaawansowany · Wersja: 3
Źródła
- ECMAScript 2024 — GetSubstitution
- ECMAScript 2024 — RegExp.prototype [ %Symbol.replace% ]
- ECMAScript 2024 — RegExp Pattern Early Errors
- ECMAScript 2025 — MightBothParticipate
- Named capturing group: (?<name>...) - JavaScript | MDN
- Named backreference: \k<name> - JavaScript | MDN
- String.prototype.replace() - JavaScript | MDN
- String.prototype.replaceAll() - JavaScript | MDN