String.prototype.matchAll()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. Itâs been available across browsers since â¨enero de 2020â©.
El método matchAll() retorna un iterador de todos los resultados de ocurrencia en una cadena de texto contra una expresión regular, incluyendo grupos de captura.
Pruébalo
const regexp = /t(e)(st(\d?))/g;
const str = "test1test2";
const array = [...str.matchAll(regexp)];
console.log(array[0]);
// Expected output: Array ["test1", "e", "st1", "1"]
console.log(array[1]);
// Expected output: Array ["test2", "e", "st2", "2"]
Sintaxis
cadena.matchAll(expresionRegular)
Parámetros
- expresionRegular
-
Un objeto expresión regular. Si se pasa un objeto no-RegExp
obj, este es implÃcitamente convertido aRegExpvÃanew RegExp(obj).
Valor devuelto
Un iterador (el cual no es reiniciable).
Ejemplo
Regexp.exec() y matchAll()
Antes de la adición de matchAll a JavaScript, fue posible hacer llamados a regexp.exec (y usar expresiones regulares con la bandera /g) en un ciclo para obtener las ocurrencias:
const regexp = RegExp("foo[a-z]*", "g");
const cadena = "mesa football, foosball";
let ocurrencia;
while ((ocurrencia = regexp.exec(cadena)) !== null) {
console.log(
`Encontrado ${ocurrencia[0]} inicio=${ocurrencia.index} final=${regexp.lastIndex}.`,
);
// salida esperada: "Encontrado football inicio=5 final=13."
// salida esperada: "Encontrado foosball inicio=15 final=23."
}
Con matchAll disponible, puedes evitar el ciclo while y exec con /g. Por el contrario, usando matchAll, obtienes un iterador con el cual puedes usar con constructores más convenientes for...of, array spread, o Array.from():
const regexp = RegExp("foo[a-z]*", "g");
const cadena = "mesa football, foosball";
const ocurrencias = cadena.matchAll(regexp);
for (const ocurrencia of ocurrencias) {
console.log(
`Encontrado ${ocurrencia[0]} inicio=${ocurrencia.index} final=${
ocurrencia.index + ocurrencia[0].length
}.`,
);
}
// salida esperada: "Encontrado football start=5 end=13."
// salida esperada: "Encontrado foosball start=15 end=23."
// el iterador ocurrencias es agotado después de la iteración for..of
// Llama matchAll de nuevo para crear un nuevo iterador
Array.from(cadena.matchAll(regexp), (m) => m[0]);
// Array [ "football", "foosball" ]
matchAll solo devuelve la primer ocurrencia si la bandera /g está ausente.
const regexp = RegExp("[a-c]", "");
const cadena = "abc";
Array.from(cadena.matchAll(regexp), (m) => m[0]);
// Array [ "a" ]
matchAll internamente hace un clon de la expresión regular, entonces a diferencia de regexp.exec, lastIndex no cambia a medida que la cadena es escaneada.
const regexp = RegExp("[a-c]", "g");
regexp.lastIndex = 1;
const cadena = "abc";
Array.from(cadena.matchAll(regexp), (m) => `${regexp.lastIndex} ${m[0]}`);
// Array [ "1 b", "1 c" ]
Mejor acceso para capturar grupos
Otra buena razón para matchAll es el mejorado acceso a los grupos de captura. Los grupos de captura son ignorados cuando se usa match() con la bandera global /g:
var regexp = /t(e)(st(\d?))/g;
var cadena = "test1test2";
cadena.match(regexp);
// Array ['test1', 'test2']
Con matchAll puedes acceder a ellos:
let array = [...str.matchAll(regexp)];
array[0];
// ['test1', 'e', 'st1', '1', index: 0, input: 'test1test2', length: 4]
array[1];
// ['test2', 'e', 'st2', '2', index: 5, input: 'test1test2', length: 4]
Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.matchall |