test (Método)

Actualización: noviembre 2007

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
Necesario. 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 identificador 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 identificador 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, s){
   var s1;                         //Declare variable.
   // Test string for existence of regular expression.
   if (re.test(s))                 //Test for existence.
      s1 = " contains ";           //s contains pattern.
   else
      s1 = " does not contain ";   //s does not contain pattern.
   return("'" + s + "'" + s1 + "'"+ re.source + "'"); //Return string.
}