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 flagre.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