RegExp.prototype.test()
Сводка
Метод 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