Поделиться через


Метод test

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

function test(str : String) : Boolean

Аргументы

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

Заметки

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

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

Пример

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

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);
}

Требования

Версия 3

Применение:

Объект Regular Expression

См. также

Ссылки

Объект RegExp

Основные понятия

Синтаксис регулярного выражения