String.prototype.search()

Метод search() виконує пошук збігів між переданим регулярним виразом і об'єктом рядка, на якому викликається.

Спробуйте його в дії

Синтаксис

search(regexp)

Параметри

regexp

Об'єкт регулярного виразу.

Якщо аргументом regexp передано не регулярний вираз, то такий аргумент неявно перетворюється на RegExp за допомогою виклику new RegExp(regexp).

Повернене значення

Індекс першого збігу вмісту рядка з регулярним виразом, або -1 — якщо збігу знайдено не було.

Опис

Коли необхідно дізнатися, чи певний патерн має збіг у рядку, і також його індекс в рядку, слід використовувати search(). (Якщо потрібно просто перевірити, чи він має збіг у рядку, то краще вжити схожий метод test() прототипного об'єкта RegExp, який повертає булеве значення.)

Для отримання докладнішої інформації (але повільнішого виконання) можна використати match() (схожий до методу exec() регулярного виразу).

Приклади

Застосування методу search()

Наступний приклад шукає збіг з двома різними регулярними виразами для ілюстрації різниці між успішним пошуком (додатне значення) та неуспішним (-1)

let str = "hey JudE"
let re = /[A-Z]/g
let reDot = /[.]/g
console.log(str.search(re))    // повертає значення 4 — індекс першої великої літери "J"
console.log(str.search(reDot)) // повертає -1 — не може знайти розділовий знак '.'

Специфікації

Сумісність із браузерами

Дивіться також

• Застосування регулярних виразів у JavaScript
• String.prototype.match()
• RegExp.prototype.exec()