CKTIS / JavaScript
Indicadores de expresiones regulares: dotAll (`s`), `u`, `i` y `g`
Los indicadores `s`, `u`, `i` y `g` controlan, respectivamente, si el punto abarca saltos de línea, el modo Unicode, la distinción de mayúsculas y la búsqueda global.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndexEscribe los indicadores tras la barra de cierre del literal (/a.b/gsui) o en el segundo argumento del constructor (new RegExp("a.b", "gsui")). El orden no importa; un indicador desconocido o repetido provoca un SyntaxError. Las propiedades dotAll, unicode, ignoreCase y global indican si están activos s, u, i y g, respectivamente; no los modifican. Estas reglas se aplican en ECMAScript 2024, pero la compatibilidad depende del entorno de ejecución.
Con s (dotAll), el comodín . también coincide con los cuatro terminadores de línea: \n, \r, U+2028 y U+2029. Esto no cambia las anclas ^ y $; m permite que también coincidan con los límites de línea. El punto escapado \. sigue siendo literal.
u activa el modo Unicode: un punto trata un par sustituto válido como 😄 como un solo punto de código y no como dos unidades UTF-16. Un punto de código no es necesariamente un grafema completo, es decir, un carácter percibido como una unidad. u también impone una sintaxis más estricta y no se puede combinar con v (SyntaxError). i ignora las diferencias entre mayúsculas y minúsculas; con u aplica el plegado simple de mayúsculas y minúsculas de Unicode, independiente de la configuración regional y sin expandir ß a ss.
g permite recorrer coincidencias que no se solapan. Con g y sin y, el método integrado exec() usa lastIndex como índice en unidades UTF-16 para determinar dónde comenzar la búsqueda. En modo Unicode, si ese índice cae dentro de un par sustituto válido, una coincidencia puede comenzar al principio del par, antes de lastIndex. Si encuentra una coincidencia, exec() guarda su posición final en lastIndex como un índice en unidades UTF-16; si falla, restablece lastIndex a 0. test() también puede modificar ese estado: para una búsqueda independiente, restablece lastIndex o usa un RegExp nuevo. Una coincidencia vacía puede atascar un bucle con exec(). Para un argumento RegExp, String.prototype.matchAll() exige g (sin él lanza TypeError), avanza tras las coincidencias vacías e itera con una copia cuyo lastIndex se inicializa con el valor actual del original.
Ejemplos
{
const text = "a\nb A😄b";
const re = /a.b/gsui;
const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);
console.log(JSON.stringify(collect(re)));
console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));
const positions = [];
for (let n = 0; n < 3; n++) {
re.exec(text);
positions.push(re.lastIndex);
}
console.log(JSON.stringify(positions));
}Resultado
["a\nb","A😄b"] [["A😄b"],["a\nb"],["a\nb"]] [3,8,0]
La primera línea muestra las dos coincidencias. En la segunda se omiten, por turno y desde el conjunto completo, `s`, `u` e `i`: desaparece la coincidencia que cruza el salto de línea, la del emoji o la de la mayúscula. La tercera línea muestra `lastIndex` tras dos aciertos y un fallo.
Lecciones relacionadas
- JavaScript · Lección 10 · Avanzado · Versión: 4