This article is in need of an editorial review.
This translation is incomplete. Please help translate this article from English.
Основное
Метод test() выполняет поиск совпадения между регулярным выражением и указанной строкой. Возвращает true или false.
Синтаксис
regexObj.test(str)
Параметры
-
str - Строка в которой будет производиться поиск.
Возвращаемое значение
Boolean. true or false.
Описание
Используйте test()каждый раз, когда вы хотите узнать, есть ли искомый шаблон в строке (аналогичен методу String.search); для большей информации (но более медленного выполнения) необходимо использовать метод exec (аналогичен методу String.match). Как и метод (или в сочетании с ним), метод exec вызывается много раз на один и тот же экземпляр глобального регулярного выражения будет находить следующие совпедения в строке.test
Примеры
Пример: Использование test
Следующий пример выводит сообщение в зависимости от того, какой результат вернёт этот метод:
function testinput(re, str){
var midstring;
if (re.test(str)) {
midstring = " contains ";
} else {
midstring = " does not contain ";
}
console.log(str + midstring + re.source);
}
Спецификации
| Спецификация | Статус | Комментарий |
|---|---|---|
| ECMAScript 3-я версия. Появился в JavaScript 1.2 | Стандартный | Изначальное определение метода |
| ECMAScript 5.1 (ECMA-262) Определение 'RegExp.test' в этой спецификации. |
Стандарт | |
| ECMAScript 6 (ECMA-262) Определение 'RegExp.test' в этой спецификации. |
Черновик |
Совместимость с браузерами
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Да) | (Да) | (Да) | (Да) | (Да) |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Да) | (Да) | (Да) | (Да) | (Да) | (Да) |
Gecko-specific notes
Prior to Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), test() was implemented incorrectly; when it was called with no parameters, it would match against the value of the previous input (RegExp.input property) instead of against the string "undefined". This is fixed; now /undefined/.test() correctly results in true, instead of an error.
See also
- Regular Expressions chapter in the JavaScript Guide
RegExp