RegExp.prototype.test()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

El métodotest() ejecuta la búsqueda de una ocurrencia entre una expresión regular y una cadena especificada. Devuelvetrue ofalse.

Sintaxis

regexObj.test(cadena)

Parámetros

cadena: La cadena a comparar contra la expresión regular.

Valor de Retorno

Retornatrue si existe una coincidencia entre la expresión regular y la cadena especificada; de lo contrario retornafalse.

Usetest() cuando desee saber si existe la ocurrencia de un patrón en una cadena (similar al métodoString.prototype.search(), la diferencia es quetest() devuelve un booleano, mientras quesearch() devuelve el índice de la coincidencia (si la encuentra) o -1 si no la encuentra).

Si requiere más información (a coste de una ejecución más lenta) utilice el métodoexec(). Al igual que este último, multiples llamadas atest() sobre la misma instancia global de una expresión regular avanzará desde de la ocurrencia anterior.

Ejemplos

Usando`test()`

Ejemplo simple que prueba si "hello" está contenido al principio de una cadena y devuelve un valor booleano.

var cadena = "hello world!";var result = /^hello/.test(cadena);console.log(result); // true

El siguiente ejemplo registra un mensaje que depende del éxito de la prueba:

function probarEntrada(regexp, cadena) {  var subcadena;  if (regexp.test(cadena)) {    subcadena = " contiene ";  } else {    subcadena = " no contiene ";  }  console.log(cadena + subcadena + regexp.source);}