CKTIS / JavaScript
Poimenovane zajemne skupine RegExp in nadomestni označevalci
Preberi zajeto besedilo po imenu skupine in ga znova uporabi v nadomestnem nizu ali funkciji, tudi ko je skupina neobvezna.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
/(?<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>...) zajame besedilo, ki ustreza delu vzorca. Poimenovane in nepoimenovane skupine se številčijo skupaj od 1 po vrstnem redu začetnih oklepajev; (?:...) ne zajema. Po uspešnem exec() prebereš vrednost z result.groups.name; če skupina ni sodelovala pri ujemanju, je vrednost undefined. Znotraj vzorca je \k<name> povratni sklic, ki preverja ujemanje z zajetim besedilom, ne pa način za vstavljanje tega besedila v rezultat zamenjave.
V nadomestnem nizu $<name> vstavi poimenovani zajem, $1 prvi zajem, $& celotno ujemanje in $$ znak za dolar. $` in $' vstavita izvirno besedilo pred ujemanjem oziroma za njim. Če ima vzorec poimenovane skupine, neznano ime ali skupina, ki ni sodelovala pri ujemanju, vstavi prazen niz. Brez poimenovanih skupin ostane $<name> dobeseden. Tudi obstoječa oštevilčena skupina, ki ni sodelovala pri ujemanju, vstavi prazen niz; če skupina 12 ne obstaja, lahko $12 pomeni $1 in dobesedni znak 2, če skupina 1 obstaja.
Nadomestna funkcija prejme celotno ujemanje, vrednosti zajemov po vrsti, položaj v kodnih enotah UTF-16, vhodni niz in na koncu objekt groups, vendar le, če vzorec vsebuje poimenovane skupine. Zajemi, ki niso sodelovali pri ujemanju, imajo vrednost undefined. Rezultat funkcije se ne obravnava kot predloga za zamenjavo: uporabi () => text, če želiš besedilo z znakom $ vstaviti dobesedno.
Pri običajnem RegExp metoda replace() brez zastavic g in y zamenja le prvo ujemanje, z g brez y pa vsa. Z y brez g zamenja največ eno ujemanje, ki se mora začeti na položaju, ki ga določa trenutna vrednost lastIndex. Z gy začne na položaju 0 in se ustavi, takoj ko na trenutnem položaju ni ujemanja, ne da bi iskala naprej. replaceAll() sproži TypeError, če regularni izraz nima zastavice g. Obe metodi vrneta rezultat kot niz, ne da bi spremenili vhod.
Imena skupin upoštevajo sintakso identifikatorjev. Neveljavno ime povzroči SyntaxError, prav tako vsako podvojeno ime v ECMAScriptu 2024. ECMAScript 2025 dovoljuje podvojena imena v različnih vejah iste disjunkcije |. Preveri podporo v ciljnem izvajalnem okolju in za združljivost z ECMAScriptom 2024 uporabi enolična imena.
Primeri
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"}]`
));Rezultat
[AB:12] [CD:] [AB:12] [CD:none]
Pri `CD` skupina `number` ne sodeluje pri ujemanju. Nadomestni niz pusti polje prazno, funkcija pa vstavi `none`.
Povezane lekcije
- JavaScript · Lekcija 25 · Srednja · Različica: 3
Viri
- 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