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 July 2015.

El método test() ejecuta la búsqueda de una ocurrencia entre una expresión regular y una cadena especificada. Devuelve true o false.

Sintaxis

regexObj.test(cadena)

Parámetros

cadena

La cadena a comparar contra la expresión regular.

Valor de Retorno

Retorna true si existe una coincidencia entre la expresión regular y la cadena especificada; de lo contrario retorna false.

Descripción

Use test() cuando desee saber si existe la ocurrencia de un patrón en una cadena (similar al método String.prototype.search(), la diferencia es que test() devuelve un booleano, mientras que search() 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étodo exec(). Al igual que este último, multiples llamadas a test() 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.

js
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:

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

Especificaciones

Specification
ECMAScript Language Specification
# sec-regexp.prototype.test

Compatibilidad con navegadores

BCD tables only load in the browser

Vea también