Baseline Widely available
El método match() devuelve todas las ocurrencias de una expresión regular dentro de una cadena.
const paragraph = "The quick brown fox jumps over the lazy dog. It barked.";
const regex = /[A-Z]/g;
const found = paragraph.match(regex);
console.log(found);
// Expected output: Array ["T", "I"]
regexp
Un objeto de expresión regular o cualquier objeto que tenga un método Symbol.match.
Si regexp no es un objeto RegExp y no tiene un método Symbol.match, se convierte implÃcitamente en RegExp usando new RegExp(regexp).
Si no se proporciona ningún parámetro y se utiliza el método match() directamente, se obtendrá un Array con una cadena vacÃa: [''], ya que esto es equivalente a match(/(?:)/).
Un Array cuyo contenido depende de la presencia de la bandera global (g), o null si no se encuentran coincidencias.
Si se usa la bandera g, se devolverán todos los resultados que coincidan con la expresión regular completa, pero no se incluirán los grupos de captura.
Si no se usa la bandera g, se devolverán sólo la primera coincidencia completa y sus grupos de captura relacionados. En este caso, match() devolverá el mismo resultado que RegExp.prototype.exec() (un Array con algunas propiedades adicionales).
La implementación de String.prototype.match en sà es muy simple. Se llama al método Symbol.match del argumento con la cadena como primer parámetro. La implementación real proviene de RegExp.prototype[@@match]().
Si se necesita saber si una cadena coincide con una expresión regular RegExp, use RegExp.prototype.test().
Si solo se desea que se encuentre la primera coincidencia, es posible que desee utilizar RegExp.prototype.exec() en su lugar.
Si se desea obtener grupos de captura y la bandera global g está siendo utilizada, debe usar RegExp.prototype.exec() o String.prototype.matchAll() en su lugar.
Para obtener más información sobre la semántica de match() cuando se pasa una expresión regular, consulte RegExp.prototype[@@match]().
En el siguiente ejemplo, se usa match para hallar 'CapÃtulo' seguido de uno o más caracteres numéricos seguidos de un punto decimal y caracteres numéricos cero o más veces.
La expresión regular incluye la bandera i por lo que las diferencias entre mayúsculas y minúsculas serán ignoradas.
const str = "Para más información, consulte el CapÃtulo 3.4.5.1";
const re = /consulte el (capÃtulo \d+(\.\d)*)/i;
const found = str.match(re);
console.log(found);
// [
// 'consulte el CapÃtulo 3.4.5.1',
// 'CapÃtulo 3.4.5.1',
// '.1',
// index: 22,
// input: 'Para más información, consulte el CapÃtulo 3.4.5.1',
// groups: undefined
// ]
En el resultado anterior:
'consulte el CapÃtulo 3.4.5.1' es la ocurrencia completa.'CapÃtulo 3.4.5.1' fue capturado por (capÃtulo \d+(\.\d)*).'.1' fue el último valor capturado por (\.\d).index (22) es el Ãndice de la coincidencia completa.input es la cadena original que se analizó.El siguiente ejemplo demuestra el uso de la bandera global e ignorar mayúsculas con match(). Se devuelven todas las letras de la A a la E y de la a a la e, cada una con su propio elemento en el array.
var str = "ABCDEFGHIJKLMNÃOPQRSTUVWXYZabcdefghijklmnñopqrstuvwxyz";
var regexp = /[A-E]/gi;
var matches = str.match(regexp);
console.log(matches);
// ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']
Nota: Véase también String.prototype.matchAll() y Búsqueda avanzada con banderas.
En los navegadores que soporten grupos de captura con nombre, el siguiente código captura 'zorro' o 'gato' en un grupo llamado animal:
const paragraph = "El veloz zorro marrón salta sobre el perro perezoso. Ladró.";
const capturingRegex = /(?<animal>zorro|gato) marrón/;
const found = paragraph.match(capturingRegex);
console.log(found.groups); // { animal: 'zorro' }
const str = "Nada saldrá de la nada.";
str.match(); // ['']
Si un objeto tiene un método Symbol.match, entonces se puede usar como un comparador personalizado. El valor de retorno de Symbol.match se convierte en el valor de retorno de match().
const str = "Mmmm, esto es interesante.";
str.match({
[Symbol.match](str) {
return ["SÃ lo es!"];
},
}); // Devuelve ['SÃ lo es!']
Véase RegExp.prototype[@@match]().
Cuando el parámetro regexp es una cadena o un número, se convierte implÃcitamente en RegExp mediante el uso de new RegExp(regexp).
const str1 =
"NaN significa que no es un número. Infinity contiene -Infinity e +Infinity en JavaScript.";
const str2 = "Mi abuelo tiene 65 años y mi abuela tiene 63 años.";
const str3 = "El contrato fue declarado null (nulo) y sin efecto.";
str1.match("número"); // 'número' es una cadena - devuelve ['número']
str1.match(NaN); // NaN es de tipo número - devuelve ['NaN']
str1.match(Infinity); // Infinity es de tipo número - devuelve ['Infinity']
str1.match(+Infinity); // devuelve ['Infinity']
str1.match(-Infinity); // devuelve ['-Infinity']
str2.match(65); // devuelve ['65']
str2.match(+65); // un número con signo positivo - devuelve ['65']
str3.match(null); // devuelve ['null']
Esto puede tener resultados inesperados si los caracteres especiales no se escapan correctamente.
console.log("123".match("1.3")); // ['123']
Esta es una ocurrencia porque . en una expresión regular coincide con todos los caracteres. Para que solo coincida con el carácter de punto, se debe escapar de la entrada.
console.log("123".match("1\\.3")); // null
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4