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® 2025 Language Specification
# sec-regexp.prototype.test

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
test

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

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