CKTIS / JavaScript
Pomenované zachytávacie skupiny RegExp a zástupné značky v náhrade
Prečítajte zachytený text podľa názvu skupiny a použite ho v náhradnom reťazci alebo vo funkcii, aj keď je skupina nepovinná.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
/(?<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>...) zachytí text zodpovedajúci časti vzoru. Pomenované aj nepomenované skupiny sa číslujú spoločne od 1 podľa poradia otváracích zátvoriek; (?:...) nič nezachytáva. Po úspešnom exec() získate hodnotu cez result.groups.name; skupina, ktorá sa na zhode nepodieľala, má hodnotu undefined. \k<name> je spätný odkaz vo vzore: slúži na nájdenie zhody so zachyteným textom, nie na jeho vloženie do výsledku nahrádzania.
V náhradnom reťazci $<name> vloží pomenovanú skupinu, $1 prvú skupinu, $& celú zhodu a $$ znak dolára. Značky $` a $' vložia pôvodný text pred zhodou a za ňou. Ak vzor obsahuje pomenované skupiny, neznámy názov alebo skupina, ktorá sa na zhode nepodieľala, dá prázdny reťazec. Bez pomenovaných skupín zostane $<name> doslovné. Existujúca číslovaná skupina, ktorá sa na zhode nepodieľala, tiež dá prázdny reťazec; ak skupina 12 neexistuje, $12 môže znamenať $1 a doslovnú 2, pokiaľ existuje skupina 1.
Nahradzovacia funkcia dostane celú zhodu, zachytené hodnoty v poradí, pozíciu v kódových jednotkách UTF-16, vstupný reťazec a napokon objekt groups, iba ak vzor obsahuje pomenované skupiny. Skupiny, ktoré sa na zhode nepodieľali, majú hodnotu undefined. Výsledok funkcie sa nevyhodnocuje ako šablóna náhrady: na doslovné vloženie textu obsahujúceho $ použite () => text.
Pri bežnom RegExp nahradí replace() bez príznakov g a y iba prvú zhodu a s g bez y všetky zhody. S y bez g nahradí najviac jednu zhodu, ktorá sa musí začínať na pozícii určenej aktuálnou hodnotou lastIndex. S gy začne na pozícii 0 a skončí, len čo na aktuálnej pozícii nenájde zhodu, bez ďalšieho hľadania. replaceAll() vyvolá TypeError, ak regulárny výraz nemá g. Obe metódy vracajú výsledný reťazec bez zmeny vstupu.
Názvy skupín sa riadia syntaxou identifikátorov. Neplatný názov spôsobí SyntaxError, rovnako ako každý duplicitný názov v ECMAScripte 2024. ECMAScript 2025 povoľuje opakovanie názvu v samostatných vetvách tej istej alternatívy |. Overte podporu v cieľovom prostredí a pre kompatibilitu s ECMAScriptom 2024 používajte jedinečné názvy.
Príklady
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"}]`
));Výsledok
[AB:12] [CD:] [AB:12] [CD:none]
Pri `CD` sa skupina `number` na zhode nepodieľa. Náhradný reťazec nechá pole prázdne, zatiaľ čo funkcia vloží `none`.
Súvisiace lekcie
- JavaScript · Lekcia 25 · Stredne pokročilá · Verzia: 3
Zdroje
- 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