Share via


test Method (JScript 5.6) 

Returns a Boolean value that indicates whether or not a pattern exists in a searched string.


rgExp.test(str) 

Arguments

  • rgExp
    Required. An instance of a Regular Expression object containing the regular expression pattern and applicable flags.
  • str
    Required. The string on which to perform the search.

Remarks

The test method checks to see if a pattern exists within a string and returns true if so, and false otherwise.

The properties of the global RegExp object are not modified by the test method.

Example

The following example illustrates the use of the test method. To use this example, pass the function a regular expression pattern and a string. The function will test for the occurrence of the regular expression pattern in the string and return a string indicating the results of that search:

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.

}

Requirements

Version 3

Applies To: Regular Expression Object (JScript 5.6)

See Also

Reference

RegExp Object (JScript 5.6)
Regular Expression Object (JScript 5.6)
Regular Expression Syntax (Scripting)