CKTIS / JavaScript
Benoemde RegExp-capturegroepen en tokens in vervangtekst
Lees vastgelegde tekst uit op groepsnaam en gebruik die opnieuw in een vervangtekst of callback, ook als een groep optioneel is.
Versie: 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>...) legt de tekst vast die overeenkomt met een deelpatroon. Benoemde en onbenoemde groepen worden samen genummerd vanaf 1, in de volgorde van hun openingshaakjes; (?:...) legt niets vast. Na een geslaagde exec() lees je de waarde met result.groups.name; een groep die niet aan de match heeft bijgedragen, heeft de waarde undefined. Binnen het patroon is \k<name> een terugverwijzing die de vastgelegde tekst probeert te matchen, niet een manier om die in het vervangingsresultaat in te voegen.
In een vervangtekst voegt $<name> een benoemde capture in, $1 de eerste capture, $& de hele match en $$ een dollarteken. $` en $' voegen de oorspronkelijke tekst vóór respectievelijk na de match in. Heeft het patroon benoemde groepen, dan levert een onbekende naam of een groep die niet heeft meegedaan een lege tekenreeks op. Zonder benoemde groepen blijft $<name> letterlijk staan. Een bestaande genummerde groep die niet heeft meegedaan levert ook een lege tekenreeks op; als groep 12 ontbreekt, kan $12 staan voor $1 gevolgd door een letterlijke 2, mits groep 1 bestaat.
De vervangfunctie krijgt de hele match, de capturewaarden in volgorde, de positie in UTF-16-code-eenheden, de invoertekenreeks en alleen bij benoemde groepen als laatste argument een groups-object. Captures die niet hebben meegedaan zijn undefined. Het functieresultaat wordt niet als vervangsjabloon verwerkt: gebruik () => text om tekst met $ letterlijk in te voegen.
Met een standaard-RegExp vervangt replace() zonder g en y alleen de eerste match, en met g zonder y alle matches. Met y zonder g vervangt de methode hoogstens één match, die moet beginnen op de positie die de huidige waarde van lastIndex aangeeft. Met gy begint de methode op positie 0 en stopt ze zodra er op de huidige positie geen match is, zonder verder te zoeken. replaceAll() veroorzaakt een TypeError als de reguliere expressie geen g heeft. Beide methoden geven een resultaattekenreeks terug zonder de invoer te wijzigen.
Groepsnamen volgen de syntaxis van identifiers. Een ongeldige naam leidt tot een SyntaxError, net als elke dubbele naam in ECMAScript 2024. ECMAScript 2025 staat dubbele namen toe in afzonderlijke takken van dezelfde |-disjunctie. Controleer de ondersteuning in je doelomgeving en gebruik unieke namen voor compatibiliteit met ECMAScript 2024.
Voorbeelden
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"}]`
));Resultaat
[AB:12] [CD:] [AB:12] [CD:none]
Bij `CD` doet de groep `number` niet mee aan de match. De vervangtekst laat het veld leeg, terwijl de callback `none` invoegt.
Gerelateerde lessen
- JavaScript · Les 25 · Gemiddeld · Versie: 3
Bronnen
- 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