CKTIS / JavaScript
String.prototype.match — podudaranja regularnog izraza
Metoda match() traži podudaranja regularnog izraza u nizu. Zastavica g mijenja oblik rezultata: bez nje dobivate najviše jedno podudaranje sa skupinama hvatanja, a s njom polje potpunih podudaranja. Ako nema podudaranja, rezultat je null.
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.match(regexp)String.prototype.match traži podudaranja uzorka u nizu, a da pritom ne mijenja niz. Za standardni objekt RegExp rezultat je polje ili null ako se ništa ne podudara. Prije pristupa elementima rezultata provjerite je li rezultat različit od null.
Ako nije postavljena ni zastavica g ni zastavica y, metoda vraća prvo podudaranje ako ono postoji. Uz y, ali bez g, metoda pokušava pronaći podudaranje koje počinje točno na položaju dobivenom pretvorbom trenutačne vrijednosti lastIndex operacijom ToLength. Stoga može vratiti kasnije podudaranje ili vratiti null čak i ako postoji podudaranje na drugom mjestu u nizu. Primjerice, ako je za /a/y vrijednost lastIndex postavljena na -1, uzorak u nizu 'a' pronalazi podudaranje na indeksu 0. Ako pronađe podudaranje bez zastavice g, element 0 sadrži cijelo podudaranje, a sljedeći elementi sadrže skupine hvatanja. Svojstvo index označava položaj podudaranja u UTF-16 kodnim jedinicama, a input sadrži pretraživani niz. Uz g, polje sadrži potpuna podudaranja koja se ne preklapaju, ali ne sadrži skupine hvatanja ni te metapodatke. Bez zastavice y pretraživanje može preskočiti dijelove niza između podudaranja. Uz obje zastavice, g i y, pretraživanje se zaustavlja čim na trenutačnom položaju nema podudaranja. Primjerice, 'a a'.match(/a/gy) vraća samo ['a'], iako se na indeksu 2 nalazi još jedno a. Za očuvanje skupina u više podudaranja upotrijebite matchAll().
Argument vrste niz tumači se kao uzorak regularnog izraza, a ne kao doslovni tekst: "abc".match(".")[0] daje "a". Izostavljanje argumenta ili prosljeđivanje vrijednosti undefined stvara prazan uzorak, pa je rezultat podudaranje s praznim nizom, a ne null.
Tehnički, metoda delegira na Symbol.match ako argument pruža tu metodu. Prilagođena implementacija stoga može vratiti drukčiju vrstu rezultata; gore opisano ponašanje s poljem odnosi se na standardno ponašanje objekta RegExp.
Primjeri
const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));Rezultat
["item-12","12",0] ["item-12","item-34"] null
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.