Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Výsledek shody RegExp: `index` a `groups`

Zjisti, kde začíná celá shoda a jaký text zachytily pojmenované skupiny. Příznak `d` přidá také počáteční a koncové pozice.

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

Syntaxe

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) vrací pole s výsledkem, nebo null, pokud shodu nenajde. Než budeš číst vlastnosti výsledku, ověř, že není null. V poli m obsahuje m[0] celou shodu. Od m[1] následují zachycené hodnoty včetně hodnot pojmenovaných skupin, a to v pořadí otevíracích závorek. m.input obsahuje celý vstupní řetězec.

m.index je počáteční pozice celé shody, počítaná od nuly v kódových jednotkách UTF-16, a to i s příznakem u. Nejde o číslo skupiny ani o re.lastIndex: s příznakem g nebo y si výraz v lastIndex ukládá pozici, od níž začne další volání exec().

Skupina zapsaná jako (?<name>...) zpřístupňuje zachycený text přes m.groups.name. Bez pojmenovaných skupin má m.groups hodnotu undefined; jinak jde o objekt bez prototypu. Skupina, která se shody neúčastnila, má hodnotu undefined, nikoli prázdný řetězec "".

Příznak d přidá m.indices: m.indices[0] je rozsah celé shody, m.indices[1] rozsah první zachycující skupiny a m.indices.groups.name rozsah pojmenované skupiny. Každá dostupná dvojice [start, end] používá pozice v jednotkách UTF-16 a nezahrnuje end, takže ji lze použít přímo v text.slice(start, end). Neúčastní-li se skupina shody, má místo dvojice hodnotu undefined; bez d vlastnost m.indices chybí. Ověř podporu příznaku d a pojmenovaných skupin v cílovém prostředí.

Se standardním RegExp vrací text.match(re) bez g stejný typ výsledku jako exec(). S g vrací jen texty celých shod nebo null, bez metadat jednotlivých shod. Chceš-li tato metadata získat, iteruj přes text.matchAll(re) s příznakem g. Iterátor používá kopii regulárního výrazu, která přebírá aktuální hodnotu re.lastIndex. Při opětovném použití výrazu s nenulovým lastIndex tak může přeskočit dřívější shody. Chceš-li hledat od začátku, použij nový regulární výraz nebo před voláním matchAll() nastav re.lastIndex = 0. Předání RegExp bez g vyvolá TypeError.

Příklady

(() => {
  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
  }));
})();

Výsledek

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

Emoji zabírá dvě kódové jednotky UTF-16 a mezera jednu, takže `id=42` začíná na pozici `3`. Skupina `id` zachytí řetězec `"42"` z rozsahu `[6, 8]`; volitelná skupina `unit` se shody neúčastní.

Související lekce

  • JavaScript · Lekce 25 · Středně pokročilá · Verze: 3

Zdroje