Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Rezultat podudaranja RegExp: `index` i `groups`

Saznaj gdje počinje cijelo podudaranje i koji su tekst uhvatile imenovane grupe. Zastavica `d` daje ti i početne i završne položaje.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const m = re.exec(text); // Match array or null
// After checking m !== null:
m.index;            // Start of the full match
m[0];               // Full matched text
m[1];               // First capture, if present
m.groups?.name;     // Text from (?<name>...) if it matched
m.indices?.[0];     // Full match range with the d flag
m.indices?.groups?.name; // Named capture range with the d flag

re.exec(text) vraća polje s rezultatom ili null ako nema podudaranja. Prije čitanja svojstava provjeri da rezultat nije null. U polju m element m[0] sadrži cijelo podudaranje, a od m[1] slijede uhvaćene vrijednosti, uključujući one iz imenovanih grupa, prema redoslijedu otvarajućih zagrada. m.input sadrži cijeli ulazni niz.

m.index je početni položaj cijelog podudaranja, brojen od nule u kodnim jedinicama UTF-16, čak i sa zastavicom u. To nije broj grupe ni re.lastIndex: uz g ili y izraz u lastIndex sprema položaj od kojeg počinje sljedeći poziv metode exec().

Grupa zapisana kao (?<name>...) omogućuje pristup uhvaćenom tekstu preko m.groups.name. Bez imenovanih grupa m.groups ima vrijednost undefined; inače je to objekt bez prototipa. Grupa koja nije sudjelovala u podudaranju ima vrijednost undefined, a ne prazan niz "".

Zastavica d dodaje m.indices: m.indices[0] raspon je cijelog podudaranja, m.indices[1] raspon prve hvatajuće grupe, a m.indices.groups.name raspon imenovane grupe. Svaki dostupan par [start, end] koristi položaje u jedinicama UTF-16 i ne uključuje end, pa se može izravno upotrijebiti u text.slice(start, end). Za grupu koja nije sudjelovala dobivaš undefined umjesto para; bez d svojstvo m.indices ne postoji. Provjeri podržava li ciljno okruženje d i imenovane grupe.

Sa standardnim RegExp objektom text.match(re) bez g daje istu vrstu rezultata kao exec(). Uz g vraća samo tekstove cijelih podudaranja ili null, bez metapodataka za pojedina podudaranja. Za pristup tim metapodacima iteriraj kroz text.matchAll(re) sa zastavicom g. Iterator koristi kopiju regularnog izraza koja preuzima trenutačnu vrijednost re.lastIndex. Ako ponovno upotrijebiš izraz čiji lastIndex nije nula, iterator može preskočiti ranija podudaranja. Za pretraživanje od početka upotrijebi novi regularni izraz ili postavi re.lastIndex = 0 prije poziva matchAll(). Prosljeđivanje objekta RegExp bez g izaziva TypeError.

Primjeri

(() => {
  const text = "😀 id=42";
  const m = /id=(?<id>\d+)(?<unit>ms)?/du.exec(text);
  if (m === null) throw new Error("Expected a match");

  const [start, end] = m.indices.groups.id;
  console.log(JSON.stringify({
    match: m[0],
    index: m.index,
    id: m.groups.id,
    idRange: [start, end],
    slicedId: text.slice(start, end),
    unitMissing: m.groups.unit === undefined
  }));
})();

Rezultat

{"match":"id=42","index":3,"id":"42","idRange":[6,8],"slicedId":"42","unitMissing":true}

Emoji zauzima dvije kodne jedinice UTF-16, a razmak jednu, pa `id=42` počinje na položaju `3`. Grupa `id` hvata niz `"42"` iz raspona `[6, 8]`; neobavezna grupa `unit` ne sudjeluje u podudaranju.

Povezane lekcije

  • JavaScript · Lekcija 25 · Srednje · Verzija: 3

Izvori