Синтаксис

regexObj.test(str)

Параметры

str

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

Возвращаемое значение

Логическое значение: true или false.

Описание

Используйте метод test(), если вы просто хотите узнать, находится ли шаблон в строке (он почти аналогичен методу String.prototype.search(), только вместо индекса шаблона возвращает true или false); для получения дополнительной информации о сопоставлении (но за счёт более медленного выполнения) используйте метод exec() (он аналогичен методу String.prototype.match()). Как и при вызове метода exec() (или при совместном с ним вызове), метод test(), вызванный несколько раз на одном и том же экземпляре глобального регулярного выражения, будет начинать проверку с конца предыдущего сопоставления.

Примеры

Пример: использование метода test()

Следующий пример печатает сообщение, в зависимости от того, была ли проверка успешной:

function testinput(re, str) {
  var midstring;
  if (re.test(str)) {
    midstring = " содержит ";
  } else {
    midstring = " не содержит ";
  }
  console.log(str + midstring + re.source);
}

Спецификации

Совместимость с браузерами

Смотрите также

• Глава про регулярные выражения в руководстве по JavaScript
• RegExp