RegExp.prototype.test()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

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

Синтаксис

regexObj.test(str)

Параметры

str

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

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

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

Описание

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

Примеры

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

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

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

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

Specification
ECMAScript Language Specification
# sec-regexp.prototype.test

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

BCD tables only load in the browser

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