CKTIS / JavaScript
Resultados de RegExp: `index` y `groups`
Localiza el inicio de la coincidencia completa y lee el texto de los grupos con nombre. La bandera `d` te da también los límites de cada intervalo.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const m = re.exec(text); // Match array or null
// After checking m !== null:
m.index; // Start of the full match
m[0]; // Full matched text
m[1]; // First capture, if present
m.groups?.name; // Text from (?<name>...) if it matched
m.indices?.[0]; // Full match range with the d flag
m.indices?.groups?.name; // Named capture range with the d flagre.exec(text) devuelve un arreglo con el resultado o null si no hay coincidencia. Comprueba que el resultado no sea null antes de leer sus propiedades. En el arreglo m, m[0] contiene la coincidencia completa. A partir de m[1] vienen las capturas, incluidas las de grupos con nombre, en el orden de los paréntesis de apertura. m.input contiene toda la cadena de entrada.
m.index es la posición inicial de la coincidencia completa, contada desde cero en unidades de código UTF-16, incluso con la bandera u. No es un número de grupo ni re.lastIndex: con g o y, la expresión guarda en lastIndex la posición desde la cual empieza la siguiente llamada a exec().
Un grupo escrito como (?<name>...) deja el texto capturado en m.groups.name. Sin grupos con nombre, m.groups vale undefined; en caso contrario, es un objeto sin prototipo. Un grupo que no participó en la coincidencia tiene el valor undefined, no la cadena vacía "".
La bandera d añade m.indices: m.indices[0] contiene el intervalo de la coincidencia completa, m.indices[1] el de la primera captura y m.indices.groups.name el de la captura con nombre. Cada par disponible [start, end] usa posiciones UTF-16 y excluye end, por lo que sirve directamente para text.slice(start, end). Si un grupo no participó, su valor es undefined en vez de un par; sin d, la propiedad m.indices no existe. Comprueba si el entorno de destino admite d y los grupos con nombre.
Con un RegExp estándar, text.match(re) sin g devuelve el mismo tipo de resultado que exec(). Con g, devuelve solo los textos de las coincidencias completas o null, sin metadatos por coincidencia. Para obtener esos metadatos, recorre text.matchAll(re) con g. El iterador usa una copia de la expresión regular cuyo lastIndex se inicializa con el valor actual de re.lastIndex, así que, al reutilizar una expresión con un lastIndex distinto de cero, puedes omitir coincidencias anteriores. Para buscar desde el principio, usa una expresión regular nueva o asigna re.lastIndex = 0 antes de llamar a matchAll(). Si pasas un RegExp sin g, se lanza un TypeError.
Ejemplos
(() => {
const text = "😀 id=42";
const m = /id=(?<id>\d+)(?<unit>ms)?/du.exec(text);
if (m === null) throw new Error("Expected a match");
const [start, end] = m.indices.groups.id;
console.log(JSON.stringify({
match: m[0],
index: m.index,
id: m.groups.id,
idRange: [start, end],
slicedId: text.slice(start, end),
unitMissing: m.groups.unit === undefined
}));
})();Resultado
{"match":"id=42","index":3,"id":"42","idRange":[6,8],"slicedId":"42","unitMissing":true}El emoji ocupa dos unidades de código UTF-16 y el espacio ocupa una, así que `id=42` empieza en `3`. El grupo `id` captura la cadena `"42"` del intervalo `[6, 8]`; el grupo opcional `unit` no participa.
Lecciones relacionadas
- JavaScript · Lección 25 · Intermedio · Versión: 3