CKTIS / JavaScript
RegExp — regularni izrazi
RegExp opisuje uzorke za pretraživanje teksta. Upoznajte zastavice, grupe, znakovne klase, kvantifikatore i polja rezultata exec(), uključujući imenovane grupe, raspone indeksa i ponašanje stanja lastIndex.
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
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp predstavlja tekstualni uzorak. Stvorite ga pomoću /pattern/flags ili new RegExp("pattern", "flags"); nizovi u konstruktoru zahtijevaju dodatnu razinu escapeanja obrnutih kosa crta: /\d+/ odgovara izrazu new RegExp("\\d+"). test() vraća logičku vrijednost; exec() vraća polje podudaranja ili null. Ovaj članak obrađuje zastavice RegExp, grupe, klase, kvantifikatore i polja rezultata.
Zastavice: g omogućuje uzastopna podudaranja, i zanemaruje velika i mala slova, m omogućuje da ^ i $ prepoznaju granice redaka, s omogućuje da se . podudara s terminatorima redaka, u uključuje Unicode način rada, v ga proširuje operacijama nad skupovima znakova, y zahtijeva podudaranje točno na poziciji lastIndex, a d dodaje raspone indeksa. u i v međusobno se isključuju; duplicirane ili nepoznate zastavice uzrokuju SyntaxError.
Klase kao što su [a-z], [^0-9] i \d odabiru znakove; \d označava ASCII znamenke. Grupe (…) hvataju tekst, (?<name>…) daje ime grupi, a (?:…) ne hvata. Kvantifikatori *, +, ? i {n,m} znače nula ili više, jedan ili više, nula ili jedan te između n i m ponavljanja. Prema zadanim postavkama pohlepni su; završni ? čini ih lijenima.
Rezultat exec() sadrži cijelo podudaranje na [0], grupe od [1] nadalje, početni položaj u index, izvorni tekst u input i imenovane grupe u groups, odnosno undefined ako nema imenovanih grupa. Grupe bez podudaranja imaju vrijednost undefined. Samo uz zastavicu d polje podudaranja sadrži polje indices: indices[0] je par indeksa za cijelo podudaranje, a sljedeći elementi sadrže parove za odgovarajuće grupe koje hvataju tekst ili undefined ako grupa nije sudjelovala u podudaranju. Svaki par određuje raspon [start,end) (bez završnog položaja) mjeren u kodnim jedinicama UTF-16, kao i index i lastIndex. Ako uzorak nema imenovanih grupa koje hvataju tekst, indices.groups ima vrijednost undefined. U suprotnom je to objekt koji svakom imenu grupe pridružuje njezin par indeksa ili undefined ako grupa nije sudjelovala u podudaranju.
Uz g ili y, i exec() i test() mijenjaju lastIndex: pri uspjehu postavlja se na kraj podudaranja, a pri neuspjehu se vraća na nulu. Prazno podudaranje u exec() ne pomiče ga automatski, pa se petlja možda neće završiti. Imenovane grupe dio su ES2018, d ES2022, a v ES2024. To su značajke ECMAScripta, a ne Web API-ji; provjerite podršku u ciljnom pregledniku neovisno o Nodeu 24 u repozitoriju.
Primjeri
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}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.