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® 2025 Language Specification
# sec-regexp.prototype.test

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
test

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Vea también