CKTIS / JavaScript
String.prototype.search — намиране на индекса на съвпадение с шаблон
Методът search() намира първото съвпадение с регулярен израз и връща индекса му или -1. Аргумент от тип низ се интерпретира като шаблон, а не като буквален подниз.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
string.search(regexp)String.prototype.search връща индекса на първото съвпадение с обикновен RegExp или -1, ако няма съвпадение. Индексът започва от нула и се измерва в UTF-16 кодови единици, а не във видими знаци. Методът не променя низа и не връща съвпадналия подниз. Проверявайте резултата с !== -1: индекс 0 означава успешно съвпадение.
Ако аргументът има метод [Symbol.search], който може да бъде извикан, search() го извиква, вместо да създава нов регулярен израз. Методът може да е собствен или наследен. Обикновените екземпляри на RegExp наследяват този метод от RegExp.prototype. Ако аргументът е null или undefined или ако прочитането на неговото свойство [Symbol.search] даде null или undefined, search() създава регулярен израз от аргумента. Всяка друга стойност на това свойство, която не може да бъде извикана, води до грешка TypeError. Затова "abc".search(".") връща 0: . съвпада с всеки знак освен знак за край на ред, а не с буквална точка. Използвайте indexOf() за търсене на буквален текст. Пропускането на аргумента или подаването на undefined създава празен шаблон и дава резултат 0.
При обикновен RegExp флагът g не събира всички съвпадения. Търсенето започва с lastIndex, зададен на 0, а след нормално завършване предишната му стойност се възстановява. Флагът y продължава да изисква съвпадение в началото на низа. Методът не приема аргумент за начална позиция.
Потребителски дефиниран метод [Symbol.search] може изцяло да определи поведението, включително типа на резултата. В примера цифрите започват на индекс 7, lastIndex остава 8, а липсата на съвпадение дава -1.
Примери
const text = "Order: 42";
const pattern = /\d+/g;
pattern.lastIndex = 8;
console.log(text.search(pattern));
console.log(pattern.lastIndex);
console.log(text.search(/missing/));
console.log("abc".search("."));Резултат
7 8 -1 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.