CKTIS / JavaScript
Grupos de captura con nombre de RegExp y sustituciones de reemplazo
Recupera el texto capturado por su nombre y reutilízalo en una cadena o función de reemplazo, incluso si algún grupo es opcional.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
/(?<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>...) captura el texto que coincide con un subpatrón. Los grupos con y sin nombre se numeran juntos desde 1, por orden de apertura de paréntesis; (?:...) no captura. Si exec() encuentra una coincidencia, puedes leer el valor mediante result.groups.name; si el grupo no participó, su valor es undefined. Dentro del patrón, \k<name> es una referencia inversa que busca una coincidencia con el texto capturado, no lo inserta en el reemplazo.
En una cadena de reemplazo, $<name> inserta una captura con nombre, $1 la primera captura, $& la coincidencia completa y $$ un signo de dólar. $` y $' insertan el texto original anterior y posterior a la coincidencia, respectivamente. Si el patrón contiene grupos con nombre, un nombre desconocido o un grupo que no participó produce una cadena vacía. Si no hay grupos con nombre, $<name> permanece literal. Un grupo numerado existente que no participó también produce una cadena vacía; si el grupo 12 no existe, $12 puede significar $1 seguido de un 2 literal, siempre que exista el grupo 1.
La función de reemplazo recibe la coincidencia completa, los valores de las capturas en orden, la posición en unidades de código UTF-16, la cadena de entrada y, solo si el patrón tiene grupos con nombre, un objeto groups al final. Las capturas que no participaron valen undefined. El resultado de la función no se interpreta como plantilla de reemplazo: usa () => text para insertar literalmente texto que contenga $.
Con una RegExp estándar, replace() reemplaza solo la primera coincidencia si no están presentes ni g ni y, y todas si está presente g sin y. Con y sin g, reemplaza como máximo una coincidencia, que debe empezar en la posición indicada por el valor actual de lastIndex. Con gy, empieza en la posición 0 y se detiene en cuanto no hay coincidencia en la posición actual, sin seguir buscando. replaceAll() lanza TypeError si la expresión regular no tiene g. Ambos métodos devuelven una cadena resultante sin modificar la entrada.
Los nombres de grupo siguen la sintaxis de los identificadores. Un nombre no válido provoca SyntaxError, al igual que cualquier nombre duplicado en ECMAScript 2024. ECMAScript 2025 admite nombres repetidos en ramas distintas de la misma disyunción |. Comprueba la compatibilidad del entorno de ejecución y usa nombres únicos para mantener la compatibilidad con ECMAScript 2024.
Ejemplos
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"}]`
));Resultado
[AB:12] [CD:] [AB:12] [CD:none]
En `CD`, el grupo `number` no participa. La cadena de reemplazo deja el campo vacío, mientras que la función inserta `none`.
Lecciones relacionadas
- JavaScript · Lección 25 · Intermedio · Versión: 3
Fuentes
- 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