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