Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Výsledok zhody RegExp: `index` a `groups`

Zisti, kde sa začína celá zhoda a aký text zachytili pomenované skupiny. Príznak `d` pridá aj počiatočné a koncové pozície.

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

Syntax

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) vráti pole s výsledkom alebo null, ak nenájde zhodu. Pred čítaním vlastností over, že výsledok nie je null. V poli m obsahuje m[0] celú zhodu. Od m[1] nasledujú zachytené hodnoty vrátane hodnôt pomenovaných skupín, a to v poradí otváracích zátvoriek. m.input obsahuje celý vstupný reťazec.

m.index je počiatočná pozícia celej zhody, počítaná od nuly v kódových jednotkách UTF-16, aj s príznakom u. Nie je to číslo skupiny ani re.lastIndex: s príznakom g alebo y si výraz do lastIndex ukladá pozíciu, od ktorej sa začne ďalšie volanie exec().

Skupina zapísaná ako (?<name>...) sprístupňuje zachytený text cez m.groups.name. Bez pomenovaných skupín má m.groups hodnotu undefined; inak je to objekt bez prototypu. Skupina, ktorá sa nezúčastnila na zhode, má hodnotu undefined, nie prázdny reťazec "".

Príznak d pridá m.indices: m.indices[0] je rozsah celej zhody, m.indices[1] rozsah prvej zachytávajúcej skupiny a m.indices.groups.name rozsah pomenovanej skupiny. Každá dostupná dvojica [start, end] používa pozície v jednotkách UTF-16 a nezahŕňa end, takže sa dá použiť priamo v text.slice(start, end). Skupina, ktorá sa nezúčastnila na zhode, má namiesto dvojice hodnotu undefined; bez d vlastnosť m.indices chýba. Over podporu príznaku d a pomenovaných skupín v cieľovom prostredí.

So štandardným RegExp vráti text.match(re) bez g rovnaký typ výsledku ako exec(). S g vráti iba texty celých zhôd alebo null, bez metadát jednotlivých zhôd. Ak chceš získať tieto metadáta, iteruj cez text.matchAll(re) s príznakom g. Iterátor používa kópiu regulárneho výrazu, ktorá preberá aktuálnu hodnotu re.lastIndex. Pri opätovnom použití výrazu s nenulovým lastIndex tak môže preskočiť skoršie zhody. Ak chceš hľadať od začiatku, použi nový regulárny výraz alebo pred volaním matchAll() nastav re.lastIndex = 0. Odovzdanie RegExp bez g vyvolá TypeError.

Prí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ýsledok

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

Emoji zaberá dve kódové jednotky UTF-16 a medzera jednu, takže `id=42` sa začína na pozícii `3`. Skupina `id` zachytí reťazec `"42"` z rozsahu `[6, 8]`; voliteľná skupina `unit` sa na zhode nezúčastní.

Súvisiace lekcie

  • JavaScript · Lekcia 25 · Stredne pokročilá · Verzia: 3

Zdroje