CKTIS / JavaScript
String.prototype.search — indeks dopasowania wzorca
Metoda search() znajduje pierwsze dopasowanie wyrażenia regularnego i zwraca jego indeks albo -1. Argument tekstowy jest interpretowany jako wzorzec, a nie dosłowny fragment tekstu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
string.search(regexp)String.prototype.search zwraca indeks pierwszego dopasowania zwykłego wyrażenia RegExp albo -1, gdy dopasowania nie ma. Indeks jest liczony od zera w jednostkach kodowych UTF-16, nie w widocznych znakach. Metoda nie zmienia tekstu i nie zwraca dopasowanego fragmentu. Sprawdzaj wynik przez !== -1: indeks 0 oznacza poprawne dopasowanie.
Jeśli argument ma wywoływalną metodę [Symbol.search], własną lub odziedziczoną, search() wywołuje ją zamiast tworzyć nowe wyrażenie regularne. Zwykłe instancje RegExp dziedziczą tę metodę z RegExp.prototype. Gdy argument ma wartość null lub undefined albo odczyt jego właściwości [Symbol.search] daje null lub undefined, search() tworzy wyrażenie regularne z argumentu. Każda inna niewywoływalna wartość tej właściwości powoduje zgłoszenie TypeError. Dlatego "abc".search(".") zwraca 0: . oznacza dowolny znak poza znakami końca wiersza, a nie dosłowną kropkę. Do wyszukiwania dosłownego tekstu użyj indexOf(). Pominięcie argumentu lub przekazanie undefined tworzy pusty wzorzec i daje 0.
Dla zwykłego RegExp flaga g nie powoduje zebrania wszystkich dopasowań. Wyszukiwanie rozpoczyna się z lastIndex równym 0, a po normalnym zakończeniu poprzednia wartość jest przywracana. Flaga y nadal wymaga dopasowania na początku tekstu. Metoda nie przyjmuje argumentu określającego pozycję początkową.
Niestandardowa metoda [Symbol.search] może całkowicie zdefiniować zachowanie, także typ wyniku. W przykładzie cyfry zaczynają się pod indeksem 7, lastIndex pozostaje równy 8, a brak dopasowania daje -1.
Przykłady
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("."));Wynik
7 8 -1 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.