test (Método)
Devuelve un valor Boolean que indica si existe o no un modelo de expresión regular en una cadena de búsqueda.
function test(str : String) : Boolean
Argumentos
- str
Obligatorio. Cadena en la que se realiza la búsqueda.
Comentarios
El método test comprueba si existe un modelo dentro de una cadena y devuelve True en tal caso o False en caso contrario. Si se encuentra una coincidencia, las propiedades del objeto RegExp global se actualizan para reflejar los resultados de la búsqueda.
Si se establece el marcador global para una expresión regular, el método test busca la cadena empezando en la posición indicada por el valor de lastIndex. Si no se establece el marcador global, test omite el valor de lastIndex y busca desde el principio de la cadena.
Ejemplo
El siguiente ejemplo muestra el uso del método test. Para utilizar este ejemplo, pase un modelo de expresión regular y una cadena a la función. La función busca la presencia del modelo de expresión regular en la cadena y devuelve una cadena que indica el resultado de la búsqueda:
function TestDemo(re, teststring)
{
// Test string for existence of regular expression.
var found = re.test(teststring)
// Format the output.
var s = "";
s += "'" + teststring + "'"
if (found)
s += " contains ";
else
s += " does not contain ";
s += "'" + re.source + "'"
return(s);
}