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

CKTIS / JavaScript

RegExp.prototype.test — comprobar si hay una coincidencia

El método test() comprueba si una expresión regular coincide con un texto y devuelve true o false. Las banderas g e y hacen que la búsqueda use lastIndex, por lo que las llamadas repetidas pueden dar resultados distintos.

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

regexp.test(string)

Llama a RegExp.prototype.test como regexp.test(string). Devuelve true cuando encuentra una coincidencia y false en caso contrario. No devuelve los grupos capturados; para obtenerlos, usa exec(). El argumento se convierte en texto. Si se omite, se convierte en el texto "undefined".

De forma predeterminada, basta con que coincida una parte del texto. Para limitar la coincidencia a los límites de la entrada, usa los anclajes ^ y $; ten en cuenta que la bandera m los convierte en límites de línea.

Con la implementación estándar de exec(), las banderas g e y usan lastIndex para determinar la posición inicial. Con g, la búsqueda puede probar posiciones posteriores, pero y no permite que avance. En modo Unicode (con u o v), si lastIndex apunta al sustituto bajo de un par de sustitutos UTF-16, la coincidencia puede empezar en el sustituto alto que lo precede, incluso con y. Si hay éxito, lastIndex se establece al final de la coincidencia; si falla, se restablece a cero. Si no se usa ninguna de las dos banderas, la implementación estándar de exec() sigue leyendo lastIndex y aplica ToLength a su valor. Si la conversión se realiza correctamente, la búsqueda empieza en la posición 0 sin modificar la propiedad lastIndex. Sin embargo, si asignas a lastIndex un valor de tipo Symbol, test() lanza un TypeError incluso sin g ni y. Para hacer comprobaciones independientes, omite g e y o establece lastIndex = 0 antes de cada llamada.

Una coincidencia vacía no hace avanzar lastIndex automáticamente: un bucle basado en test() puede no terminar. El método usa exec(), así que sobrescribirlo puede cambiar el comportamiento. Esta es una API del lenguaje ECMAScript, no una API del navegador.

Ejemplos

const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));

Resultado

true
3
false
0
true

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