String.prototype.search()
Сводка
Метод search()
выполняет поиск сопоставления между регулярным выражением и этим объектом String
.
Синтаксис
str.search([regexp])
Параметры
regexp
-
Необязательный параметр. Объект регулярного выражения. Если будет передан не объект регулярного выражения, он будет неявно преобразован в объект
RegExp
через вызов конструктораnew RegExp(regexp)
.
Описание
При успехе метод search()
возвращает индекс первого сопоставления с регулярным выражением внутри строки. В противном случае метод вернёт -1.
Если вы хотите узнать, находится ли шаблон в строке, используйте метод search()
(он работает почти так же, как и метод test()
регулярного выражения, но вместо наличия подстроки возвращает её индекс); для получения дополнительной информации (за счёт более медленного выполнения) используйте метод match()
(работает так же, как метод exec()
регулярного выражения).
Примеры
Пример: использование метода search()
В следующем примере в журнал попадает сообщение, зависящее от успешности или неуспешности прохождения проверки.
js
function testInput(re, str) {
var midstring;
if (str.search(re) != -1) {
midstring = " содержит ";
} else {
midstring = " не содержит ";
}
console.log(str + midstring + re);
}
var testString = "hey JuDe";
var re = /[A-Z]/g;
testInput(re, testString); // выведет: hey Jude содержит /[A-Z]/g
Спецификации
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.search |
Совместимость с браузерами
BCD tables only load in the browser