Метод test

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает логическое значение, указывающее, существует ли шаблон регулярного выражения в строке, в которой выполняется поиск.

function test(str : String) : Boolean

Аргументы

str
Обязательный. Строка, в которой выполняется поиск.

Заметки

Метод test проверяет, существует ли шаблон в строке, и возвращает значение true, если шаблон существует, и false в противном случае. Если соответствие найдено, свойства глобального объекта RegExp обновляются в соответствии с результатами поиска.

Если для регулярного выражения установлен глобальный флаг, метод test выполняет поиск в строке, начиная с позиции, указанной значением lastIndex. Если глобальный флаг не установлен, метод test пропускает значение lastIndex и выполняет поиск с начала строки.

Пример

В следующем примере показано использование метода test. Чтобы использовать этот пример, передайте функции шаблон регулярного выражения и строку. Функция проверит, присутствует ли шаблон регулярного выражения в строке, и возвратит строку, указывающую результаты поиска.

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.
}