Método match() de String en JavaScript

Definición y uso

match() El método realiza la coincidencia entre la cadena y la expresión regular.

Consejo:Si el valor de búsqueda es una cadena, se convierte en una expresión regular.

match() El método devuelve un array que contiene elementos coincidentes.

Si no se encuentra ninguna coincidencia, se devuelve match() El método devuelve null.

Véase también:

Tutoriales de expresiones regulares

Manual de referencia de expresiones regulares

Diferencia entre String match() y String search()

match() El método devuelve el array de coincidencias.

search() El método devuelve la posición de la primera coincidencia.

Ejemplo

Ejemplo 1

Búsqueda de "ain" utilizando cadena:

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Prueba personalmente

Ejemplo 2

Búsqueda de "ain" utilizando expresión regular:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Prueba personalmente

Ejemplo 3

Búsqueda global de "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Prueba personalmente

Ejemplo 4

Búsqueda global, insensible a mayúsculas y minúsculas:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Prueba personalmente

Sintaxis

cadena.match(regexp)

Parámetro

Parámetro Descripción
regexp

Obligatorio. Valor de búsqueda.

Expresión regular (o la cadena que se convertirá en expresión regular).

Valor de retorno

Tipo Descripción
Array o null

Array que contiene elementos coincidentes.

Si no se encuentra ningún elemento coincidente, se devuelve null.

Detalles técnicos

Parámetro regexp

Este parámetro especifica el objeto RegExp del patrón que se debe coincidir. Si este parámetro no es un objeto RegExp, se lo pasará primero al constructor RegExp(), convirtiéndolo en un objeto RegExp.

Valor de retorno

El array que almacena los resultados de la coincidencia. El contenido del array depende de regexp ¿Tiene la bandera global? g¿Tiene la bandera global?

A continuación, se detalla el valor de retorno.

match() Descripción cadenaEl método buscará la cadena regexp para encontrar una o más coincidencias con regexp ¿Tiene el símbolo g.

Si regexp sin el símbolo g, entonces match() El método solo puede cadena Si no se encuentra ningún texto coincidente,match() Se ejecutará una coincidencia una vez en null. De lo contrario, regresará un array que contiene información relacionada con el texto coincidente que ha encontrado. El primer elemento del array almacenado es el texto coincidente, y los otros elementos son los textos que coinciden con los subpatrones de la expresión regular. Además de estos elementos de array comunes, el array devuelto también contiene dos propiedades de objeto. La propiedad index declara la posición de inicio del texto coincidente en cadena La propiedad de input declara la posición en cadena de la referencia.

Si regexp con el símbolo gEntonces match() El método ejecutará la búsqueda global, encontrando cadena Todas las subcadenas coincidentes. Si no se encuentra ninguna subcadena coincidente, se devuelve null. Si se encuentra una o más subcadenas coincidentes, se devuelve un array. Sin embargo, el contenido del array devuelto por la coincidencia global es muy diferente al anterior, sus elementos del array contienen cadena Tiene todas las subcadenas coincidentes y no tiene propiedades de index o input.

Nota:En el modo de búsqueda global,match() No proporciona información sobre el texto que coincide con los subexpresiones ni declara la posición de cada subcadena coincidente. Si necesita esta información de búsqueda global, puede usar RegExp.exec().

Métodos de búsqueda de expresiones regulares

En JavaScript, la búsqueda de texto con expresiones regulares se puede realizar con diferentes métodos.

Estos son los métodos más comunes al usar el patrón como expresión regular:

Ejemplo Descripción
text.match(patrón) Método match() de cadena
text.search(patrón) Método search() de cadena
patrón.exec(text) Método exec() de expresiones regulares
patrón.test(text) Método test() de expresiones regulares

Soporte del navegador

match() Es una característica de ECMAScript1 (ES1).

Todos los navegadores admiten completamente ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Soporte Soporte Soporte Soporte Soporte Soporte

Páginas relacionadas

Cadena de caracteres en JavaScript

Métodos de cadena en JavaScript

Búsqueda de cadena en JavaScript