Método match

El método match devuelve un array de coincidencias con una expresión regular. Si no hay coincidencias, devuelve null. Al ser invocado sin el modificador g el método devuelve un array, en cuyo elemento cero estará la subcadena encontrada, y en los demás elementos - los grupos de captura. Si el método se invoca con el modificador g devuelve todas las coincidencias encontradas en forma de array.

Sintaxis

javascriptcadena.match(expresión regular);

Ejemplo

Encontremos una coincidencia con una expresión regular y descompongámosla en grupos de captura:

javascriptlet str = '12:34';
let res = str.match(/(\d+):(\d+)/);

console.log(res[0]); // lo encontrado
console.log(res[1]); // grupo 1
console.log(res[2]); // grupo 2

Resultado de la ejecución del código:

javascript'12:34'
'12'
'34'

Ejemplo

Obtengamos un array de subcadenas que consisten en la letra 'a':

javascriptlet str = 'a aa aaa aaaa';
let res = str.match(/a+/g);

console.log(res);

Resultado de la ejecución del código:

javascript['a', 'aa', 'aaa', 'aaaa']

Véase también

  • método test,
    que comprueba una cadena
  • método matchAll,
    que busca todas las coincidencias en una cadena
  • método exec,
    que realiza una búsqueda secuencial
  • método replace,
    que realiza búsqueda y reemplazo
  • método search,
    que realiza una búsqueda
  • método split,
    que divide una cadena