Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

String.prototype.match — ujemanja regularnega izraza

Metoda match() v nizu išče ujemanja z regularnim izrazom. Zastavica g spremeni obliko rezultata: brez nje dobite največ eno ujemanje z zajetimi skupinami, z njo pa polje celotnih ujemanj. Če ni ujemanja, vrne null.

Različica: 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 v nizu išče ujemanja z vzorcem, ne da bi niz spremenila. Pri standardnem objektu RegExp je rezultat polje ali null, če se nič ne ujema. Pred dostopom do elementov rezultata preverite, ali rezultat ni null.

Če ni nastavljena niti zastavica g niti zastavica y, metoda vrne prvo ujemanje, če obstaja. Z zastavico y, vendar brez g, poskuša najti ujemanje, ki se začne natanko na položaju, dobljenem s pretvorbo trenutne vrednosti lastIndex z operacijo ToLength. Zato lahko vrne poznejše ujemanje ali pa null, čeprav se vzorec ujema drugje v nizu. Če je na primer pri /a/y vrednost lastIndex nastavljena na -1, vzorec v nizu 'a' najde ujemanje na indeksu 0. Pri ujemanju brez zastavice g element 0 vsebuje celotno ujemanje, naslednji elementi pa zajete skupine. Lastnost index podaja položaj ujemanja v kodnih enotah UTF-16, input pa vsebuje iskani niz. Z zastavico g polje vsebuje celotna ujemanja, ki se ne prekrivajo, ne vsebuje pa zajetih skupin ali teh metapodatkov. Brez zastavice y lahko iskanje preskoči dele niza med ujemanji. Z obema zastavicama, g in y, se iskanje konča, takoj ko na trenutnem položaju ni ujemanja. Na primer, 'a a'.match(/a/gy) vrne samo ['a'], čeprav je na indeksu 2 še en a. Če želite ohraniti skupine pri več ujemanjih, uporabite matchAll().

Argument vrste niz se razume kot vzorec regularnega izraza, ne kot dobesedno besedilo: "abc".match(".")[0] vrne "a". Če argument izpustite ali podate undefined, se ustvari prazen vzorec, zato je rezultat ujemanje s praznim nizom, ne null.

Tehnično metoda delegira na Symbol.match, če argument ponuja to metodo. Prilagojena implementacija lahko zato vrne drugo vrsto rezultata; zgoraj opisano vedenje s poljem velja za standardno vedenje RegExp.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri