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()
Следующий пример печатает сообщение, в зависимости от того, была ли проверка успешной:
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
Смотрите также
- Глава про регулярные выражения в руководстве по JavaScript
RegExp