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.
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);
}
Especificaciones
Specification |
---|
ECMAScript Language Specification # sec-regexp.prototype.test |
Compatibilidad con navegadores
BCD tables only load in the browser
Vea también
- El capítulo Expresiones Regulares de la Guía JavaScript
RegExp