Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Imenovane grupe za hvatanje u RegExp-u i oznake u zamjenskom nizu

Dohvati uhvaćeni tekst po nazivu grupe i ponovno ga upotrijebi u zamjenskom nizu ili funkciji, čak i kada je grupa neobavezna.

Verzija: 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>...) hvata tekst koji odgovara dijelu uzorka. Imenovane i neimenovane grupe numeriraju se zajedno od 1 po redoslijedu otvorenih zagrada; (?:...) ne hvata tekst. Nakon uspješnog exec() vrijednost je dostupna preko result.groups.name; grupa koja nije sudjelovala u podudaranju ima vrijednost undefined. U uzorku je \k<name> povratna referenca koja traži podudaranje s uhvaćenim tekstom, a ne umeće ga u rezultat zamjene.

U zamjenskom nizu $<name> umeće imenovanu grupu, $1 prvu grupu, $& cijelo podudaranje, a $$ znak dolara. $` i $' umeću izvorni tekst prije odnosno nakon podudaranja. Ako uzorak ima imenovane grupe, nepoznato ime ili grupa koja nije sudjelovala u podudaranju daje prazan niz. Bez imenovanih grupa $<name> ostaje doslovan. Postojeća numerirana grupa koja nije sudjelovala također daje prazan niz; ako grupa 12 ne postoji, $12 može značiti $1 nakon kojeg slijedi doslovna 2, pod uvjetom da grupa 1 postoji.

Zamjenska funkcija prima cijelo podudaranje, uhvaćene vrijednosti redom, položaj u kodnim jedinicama UTF-16, ulazni niz te objekt groups na kraju, samo ako uzorak ima imenovane grupe. Grupe koje nisu sudjelovale u podudaranju imaju vrijednost undefined. Rezultat funkcije ne tumači se kao predložak zamjene: upotrijebi () => text za doslovno umetanje teksta koji sadrži $.

Uz standardni RegExp, replace() bez zastavica g i y zamjenjuje samo prvo podudaranje, a s g bez y zamjenjuje sva podudaranja. S y bez g zamjenjuje najviše jedno podudaranje, koje mora početi na položaju određenom trenutačnom vrijednošću lastIndex. S gy počinje na položaju 0 i zaustavlja se čim na trenutačnom položaju nema podudaranja, bez daljnjeg traženja. replaceAll() baca TypeError ako regularni izraz nema g. Obje metode vraćaju rezultirajući niz bez promjene ulaza.

Imena grupa slijede sintaksu identifikatora. Nevaljano ime uzrokuje SyntaxError, kao i svako ponovljeno ime u ECMAScriptu 2024. ECMAScript 2025 dopušta ponavljanje imena u odvojenim granama iste disjunkcije |. Provjeri podršku u ciljanom izvršnom okruženju i koristi jedinstvena imena radi kompatibilnosti s ECMAScriptom 2024.

Primjeri

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]

Kod `CD` grupa `number` ne sudjeluje u podudaranju. Zamjenski niz ostavlja polje praznim, a funkcija umeće `none`.

Povezane lekcije

  • JavaScript · Lekcija 25 · Srednje · Verzija: 3

Izvori