String.prototype.search()

Сводка

Метод search() выполняет поиск сопоставления между регулярным выражением и этим объектом String.

Синтаксис

str.search([regexp])

Параметры

regexp

Необязательный параметр. Объект регулярного выражения. Если будет передан не объект регулярного выражения, он будет неявно преобразован в объект RegExp через вызов конструктора new RegExp(regexp).

Описание

При успехе метод search() возвращает индекс первого сопоставления с регулярным выражением внутри строки. В противном случае метод вернёт -1.

Если вы хотите узнать, находится ли шаблон в строке, используйте метод search() (он работает почти так же, как и метод test() регулярного выражения, но вместо наличия подстроки возвращает её индекс); для получения дополнительной информации (за счёт более медленного выполнения) используйте метод match() (работает так же, как метод exec() регулярного выражения).

Примеры

В следующем примере в журнал попадает сообщение, зависящее от успешности или неуспешности прохождения проверки.

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

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