Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.search — pronalaženje indeksa podudaranja uzorka

Metoda search() pronalazi prvo podudaranje regularnog izraza i vraća njegov indeks ili -1. Argument tipa string tumači se kao uzorak, a ne kao doslovni podniz.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

string.search(regexp)

String.prototype.search vraća indeks prvog podudaranja s običnim RegExp ili -1 ako podudaranja nema. Indeks počinje od nule i mjeri se u UTF-16 kodnim jedinicama, a ne u vidljivim znakovima. Metoda ne mijenja string niti vraća podudarni podniz. Rezultat provjerite pomoću !== -1: indeks 0 znači da je podudaranje uspješno.

Ako argument ima metodu [Symbol.search] koju je moguće pozvati, bilo da je vlastita ili naslijeđena, search() je poziva umjesto da stvori novi regularni izraz. Obične instance RegExp nasljeđuju tu metodu iz RegExp.prototype. Ako je argument null ili undefined ili ako čitanje njegova svojstva [Symbol.search] daje null ili undefined, search() iz argumenta stvara regularni izraz. Svaka druga vrijednost tog svojstva koju nije moguće pozvati uzrokuje pogrešku TypeError. Zato "abc".search(".") vraća 0: . podudara se sa svakim znakom osim znaka za završetak retka, a ne s doslovnom točkom. Za pretraživanje doslovnog teksta upotrijebite indexOf(). Izostavljanje argumenta ili prosljeđivanje vrijednosti undefined stvara prazan uzorak i daje rezultat 0.

Kod običnog RegExp zastavica g ne prikuplja sva podudaranja. Pretraživanje počinje s lastIndex postavljenim na 0, a nakon uobičajenog završetka vraća se prethodna vrijednost. Zastavica y i dalje zahtijeva podudaranje na početku stringa. Metoda ne prihvaća argument koji određuje početni položaj.

Prilagođena metoda [Symbol.search] može u potpunosti odrediti ponašanje, uključujući vrstu rezultata. U primjeru znamenke počinju na indeksu 7, lastIndex ostaje 8, a izostanak podudaranja daje -1.

Primjeri

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("."));

Rezultat

7
8
-1
0

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori