Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Pojmenované zachytávací skupiny RegExp a zástupné značky v náhradě

Přečtěte zachycený text podle názvu skupiny a znovu ho použijte v náhradním řetězci nebo funkci, i když je skupina nepovinná.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

/(?<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 odpovídající části vzoru. Pojmenované i nepojmenované skupiny se číslují společně od 1 podle pořadí otevíracích závorek; (?:...) nic nezachytává. Po úspěšném exec() získáte hodnotu přes result.groups.name; skupina, která se na shodě nepodílela, má hodnotu undefined. \k<name> je zpětný odkaz uvnitř vzoru: slouží k nalezení shody se zachyceným textem, nikoli k jeho vložení do výsledku nahrazení.

V náhradním řetězci $<name> vloží pojmenovanou skupinu, $1 první skupinu, $& celou shodu a $$ znak dolaru. Značky $` a $' vkládají původní text před shodou a za ní. Pokud vzor obsahuje pojmenované skupiny, neznámý název i skupina, která se na shodě nepodílela, dají prázdný řetězec. Bez pojmenovaných skupin zůstane $<name> doslovně. Existující číslovaná skupina, která se na shodě nepodílela, také dá prázdný řetězec; pokud skupina 12 neexistuje, $12 může znamenat $1 a doslovnou 2, pokud skupina 1 existuje.

Nahrazovací funkce dostane celou shodu, zachycené hodnoty v pořadí, pozici v kódových jednotkách UTF-16, vstupní řetězec a nakonec objekt groups, pouze pokud má vzor pojmenované skupiny. Skupiny, které se na shodě nepodílely, mají hodnotu undefined. Výsledek funkce se už nevyhodnocuje jako šablona náhrady: použijte () => text, chcete-li vložit text obsahující $ doslovně.

S běžným RegExp nahradí replace() bez příznaků g a y jen první shodu, s g bez y všechny shody. S y bez g nahradí nejvýše jednu shodu, která musí začínat na pozici určené aktuální hodnotou lastIndex. S gy začne na pozici 0 a skončí, jakmile na aktuální pozici nenajde shodu, aniž hledá dál. replaceAll() vyvolá TypeError, pokud regulární výraz nemá g. Obě metody vracejí výsledný řetězec, aniž změní vstup.

Názvy skupin se řídí syntaxí identifikátorů. Neplatný název způsobí SyntaxError, stejně jako každý duplicitní název v ECMAScriptu 2024. ECMAScript 2025 povoluje opakování názvu v různých větvích téže alternativy |. Ověřte podporu v cílovém běhovém prostředí; pro kompatibilitu s ECMAScriptem 2024 používejte jedinečné názvy.

Pří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ýsledek

[AB:12] [CD:]
[AB:12] [CD:none]

U `CD` se skupina `number` na shodě nepodílí. Náhradní řetězec nechá pole prázdné, zatímco funkce vloží `none`.

Související lekce

  • JavaScript · Lekce 25 · Středně pokročilá · Verze: 3

Zdroje