Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.match — coincidencias de expresiones regulares

El método match() busca coincidencias de una expresión regular en una cadena. La bandera g cambia la forma del resultado: sin ella, se obtiene como máximo una coincidencia con sus grupos de captura; con ella, un array de coincidencias completas. Si no hay coincidencias, devuelve null.

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

string.match(regexp)

String.prototype.match busca coincidencias de un patrón en una cadena sin modificarla. Con un objeto RegExp estándar, el resultado es un array o null si no hay coincidencias. Comprueba que el resultado no sea null antes de acceder a sus elementos.

Sin las banderas g e y, el método devuelve la primera coincidencia, si existe. Con y pero sin g, solo intenta encontrar una coincidencia que empiece exactamente en la posición obtenida al aplicar ToLength al valor actual de lastIndex. Por tanto, puede devolver una coincidencia posterior o devolver null aunque el patrón coincida en otra parte de la cadena. Por ejemplo, si lastIndex vale -1 en /a/y, el patrón encuentra una coincidencia en el índice 0 de 'a'. Si encuentra una coincidencia sin g, el elemento 0 contiene la coincidencia completa y los elementos siguientes contienen los grupos de captura. La propiedad index indica la posición de la coincidencia en unidades de código UTF-16, y input contiene la cadena buscada. Con g, el array contiene coincidencias completas que no se solapan, pero no incluye los grupos de captura ni esos metadatos. Sin y, la búsqueda puede saltar los tramos de la cadena que separan las coincidencias. Con g e y, se detiene en cuanto el patrón deja de coincidir en la posición actual. Por ejemplo, 'a a'.match(/a/gy) devuelve solo ['a'], aunque haya otra a en el índice 2. Para conservar los grupos de varias coincidencias, usa matchAll().

Un argumento de tipo cadena se interpreta como un patrón de expresión regular, no como texto literal: "abc".match(".")[0] produce "a". Omitir el argumento o pasar undefined crea un patrón vacío, por lo que el resultado es una coincidencia con la cadena vacía, no null.

Técnicamente, el método delega en Symbol.match si el argumento proporciona ese método. Por tanto, una implementación personalizada puede devolver un tipo de resultado distinto; el comportamiento de array descrito arriba corresponde al comportamiento estándar de RegExp.

Ejemplos

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Resultado

["item-12","12",0]
["item-12","item-34"]
null

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.

Fuentes