CKTIS / JavaScript
RegExp — expresiones regulares
RegExp describe patrones para buscar en texto. Aprende sobre indicadores, grupos, clases de caracteres, cuantificadores y campos del resultado de exec(), incluidas las capturas con nombre, los rangos de índices y el comportamiento con estado de lastIndex.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp representa un patrón de texto. Créalo con /pattern/flags o new RegExp("pattern", "flags"); las cadenas del constructor necesitan un nivel adicional de escape de las barras inversas: /\d+/ corresponde a new RegExp("\\d+"). test() devuelve un booleano; exec() devuelve una matriz de coincidencia o null. Esta entrada trata los indicadores de RegExp, los grupos, las clases, los cuantificadores y los campos del resultado.
Indicadores: g permite búsquedas sucesivas, i ignora mayúsculas y minúsculas, m hace que ^ y $ reconozcan los límites de línea, s permite que . coincida con terminadores de línea, u activa el modo Unicode, v amplía ese modo con operaciones de conjuntos de caracteres, y exige una coincidencia exactamente en lastIndex y d añade rangos de índices. u y v son incompatibles; los indicadores duplicados o desconocidos provocan un SyntaxError.
Clases como [a-z], [^0-9] y \d seleccionan caracteres; \d significa dígitos ASCII. Los grupos (…) capturan texto, (?<name>…) asigna un nombre a una captura y (?:…) no captura. Los cuantificadores *, +, ? y {n,m} significan cero o más, uno o más, cero o uno y entre n y m repeticiones. De forma predeterminada son codiciosos; un ? final los hace perezosos.
El resultado de exec() contiene la coincidencia completa en [0], las capturas a partir de [1], la posición inicial en index, el texto original en input y las capturas con nombre en groups, o undefined si no hay grupos con nombre. Las capturas sin coincidencia tienen el valor undefined. Solo con el indicador d se incluye el array indices en el resultado de la coincidencia: indices[0] es el par de índices de la coincidencia completa, y los elementos siguientes contienen los pares de las capturas correspondientes o undefined para las que no participaron en la coincidencia. Cada par delimita un rango [start,end) (con el extremo final excluido) medido en unidades de código UTF-16, igual que index y lastIndex. Si el patrón no contiene capturas con nombre, indices.groups vale undefined. Si las contiene, es un objeto que asocia cada nombre de captura con su par de índices o con undefined si esa captura no participó en la coincidencia.
Con g o y, tanto exec() como test() modifican lastIndex: si hay éxito, se establece en el final de la coincidencia; si falla, se restablece a cero. Una coincidencia vacía no lo incrementa automáticamente en exec(), así que un bucle puede no terminar. Los grupos con nombre son de ES2018, d de ES2022 y v de ES2024. Son funciones de ECMAScript, no API web; comprueba la compatibilidad en el navegador de destino independientemente de Node 24 del repositorio.
Ejemplos
const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
match: m[0],
captures: [m[1], m[2]],
key: m.groups.key,
index: m.index,
input: m.input,
span: m.indices[0],
keySpan: m.indices.groups.key,
lastIndex: re.lastIndex
}));Resultado
{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.