RegExp.prototype.test()

Метод test() выполняет поиск сопоставления регулярного выражения указанной строке. Возвращает true или false.

regexObj.test(str)

str

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

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

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

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

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

До Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5) метод test() был реализован неправильно; когда он вызывался без параметров, он проверял на сопоставление предыдущее проверенное значение (свойство RegExp.input) вместо сопоставления со строкой "undefined". Это поведение было исправлено; теперь /undefined/.test() правильно вернёт true вместо ошибки.

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