База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Именувани прихващащи групи в RegExp и маркери в низа за замяна

Извличай прихванатия текст по име на групата и го използвай отново в низ или функция за замяна, дори когато групата не е задължителна.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

/(?<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>...) прихваща текста, който съвпада с част от шаблона. Именуваните и неименуваните групи се номерират заедно от 1 според реда на отварящите скоби; (?:...) не прихваща. След успешен exec() стойността е достъпна чрез result.groups.name; група, която не е участвала в съвпадението, има стойност undefined. В шаблона \k<name> е обратна препратка, която търси съвпадение с прихванатия текст, вместо да го вмъква в резултата от замяната.

В низ за замяна $<name> вмъква текста от именувана група, $1 — текста от първата група, $& — цялото съвпадение, а $$ — знак за долар. $` и $' вмъкват оригиналния текст съответно преди и след съвпадението. Ако шаблонът има именувани групи, непознато име или неучаствала група дава празен низ. Без именувани групи $<name> остава буквален текст. Съществуваща номерирана група, която не е участвала, също дава празен низ; ако група 12 липсва, $12 може да означава $1, последвано от буквално 2, стига група 1 да съществува.

Функцията за замяна получава цялото съвпадение, стойностите на групите по ред, позицията в кодови единици UTF-16, входния низ и накрая обект groups само ако шаблонът съдържа именувани групи. Неучаствалите групи имат стойност undefined. Върнатата стойност не се обработва като шаблон за замяна: използвай () => text, за да вмъкнеш буквално текст, съдържащ $.

При стандартен RegExp методът replace() заменя само първото съвпадение, ако няма нито g, нито y, а с g без y заменя всички съвпадения. С y без g заменя най-много едно съвпадение, което трябва да започва на позицията, определена от текущата стойност на lastIndex. С gy започва от позиция 0 и спира, щом на текущата позиция няма съвпадение, без да търси по-нататък. replaceAll() предизвиква TypeError, ако регулярният израз е без g. И двата метода връщат резултатен низ, без да променят входа.

Имената на групите следват синтаксиса на идентификаторите. Невалидно име води до SyntaxError, както и всяко повторено име в ECMAScript 2024. ECMAScript 2025 допуска повторение на име в отделни клонове на една и съща алтернатива |. Провери поддръжката в целевата среда за изпълнение и използвай уникални имена за съвместимост с ECMAScript 2024.

Примери

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"}]`
));

Резултат

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

При `CD` групата `number` не участва в съвпадението. Низът за замяна оставя полето празно, а функцията вмъква `none`.

Свързани уроци

  • JavaScript · Урок 25 · Средно · Версия: 3

Източници