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

CKTIS / JavaScript

RegExp — regularni izrazi

RegExp opisuje vzorce za iskanje po besedilu. Spoznajte zastavice, skupine, znakovne razrede, kvantifikatorje in polja rezultata exec(), vključno s poimenovanimi zajetji, območji indeksov in stanjem lastIndex.

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

/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)

RegExp predstavlja besedilni vzorec. Ustvarite ga z /pattern/flags ali new RegExp("pattern", "flags"); nizi konstruktorja zahtevajo dodatno raven ubežanja poševnic nazaj: /\d+/ ustreza new RegExp("\\d+"). test() vrne logično vrednost; exec() vrne polje ujemanja ali null. Ta članek obravnava zastavice RegExp, skupine, razrede, kvantifikatorje in polja rezultata.

Zastavice: g omogoča zaporedna ujemanja, i prezre velikost črk, m omogoči, da ^ in $ prepoznata meje vrstic, s omogoči, da se . ujema z zaključki vrstic, u vključi način Unicode, v ga razširi z operacijami nad nizi znakov, y zahteva ujemanje natančno pri lastIndex, d pa doda območja indeksov. u in v se izključujeta; podvojene ali neznane zastavice povzročijo SyntaxError.

Razredi, kot so [a-z], [^0-9] in \d, izbirajo znake; \d pomeni števke ASCII. Skupine (…) zajamejo besedilo, (?<name>…) poimenuje zajetje, (?:…) pa ne zajema. Kvantifikatorji *, +, ? in {n,m} pomenijo nič ali več, eno ali več, nič ali eno ter od n do m ponovitev. Privzeto so požrešni; zaključni ? jih naredi lenobne.

Rezultat exec() vsebuje celotno ujemanje pri [0], zajetja od [1] naprej, začetni položaj v index, izvirno besedilo v input in poimenovana zajetja v groups oziroma undefined, če ni poimenovanih skupin. Zajetja brez ujemanja imajo vrednost undefined. Polje ujemanja vsebuje polje indices samo z zastavico d: indices[0] je par indeksov za celotno ujemanje, naslednji elementi pa vsebujejo pare za ustrezna zajetja ali undefined za zajetja, ki niso sodelovala pri ujemanju. Vsak par določa območje [start,end) (brez končnega položaja) v kodnih enotah UTF-16, tako kot index in lastIndex. Če vzorec nima poimenovanih zajetij, je indices.groups enak undefined. Sicer je to objekt, ki vsakemu imenu zajetja priredi njegov par indeksov ali undefined, če zajetje ni sodelovalo pri ujemanju.

Z g ali y tako exec() kot test() spreminjata lastIndex: ob uspehu se nastavi na konec ujemanja, ob neuspehu pa na nič. Prazno ujemanje v exec() vrednosti ne poveča samodejno, zato se zanka morda ne konča. Poimenovane skupine izvirajo iz ES2018, d iz ES2022, v pa iz ES2024. To so funkcije ECMAScript, ne spletni API-ji; podporo v ciljnem brskalniku preverite neodvisno od Node 24 v repozitoriju.

Primeri

const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
  match: m[0],
  captures: [m[1], m[2]],
  key: m.groups.key,
  index: m.index,
  input: m.input,
  span: m.indices[0],
  keySpan: m.indices.groups.key,
  lastIndex: re.lastIndex
}));

Rezultat

{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}

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

Viri