CKTIS / JavaScript
Rezultat ujemanja RegExp: `index` in `groups`
Ugotovi, kje se začne celotno ujemanje in kaj so zajele poimenovane skupine. Z zastavico `d` dobiš tudi začetne in končne položaje.
Različica: 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 flagre.exec(text) vrne tabelo z rezultatom ali null, če ni ujemanja. Pred branjem lastnosti preveri, da rezultat ni null. V tabeli m je m[0] celotno ujemanje, od m[1] dalje pa so zajete vrednosti, tudi iz poimenovanih skupin, po vrstnem redu začetnih oklepajev. m.input vsebuje celoten vhodni niz.
m.index je začetni položaj celotnega ujemanja, štet od nič v kodnih enotah UTF-16, tudi z zastavico u. To ni številka skupine niti re.lastIndex: pri g ali y izraz v lastIndex shrani položaj, na katerem se začne naslednji klic exec().
Skupina, zapisana kot (?<name>...), omogoča dostop do zajetega besedila prek m.groups.name. Brez poimenovanih skupin ima m.groups vrednost undefined; sicer je to objekt brez prototipa. Skupina, ki ni sodelovala pri ujemanju, ima vrednost undefined, ne praznega niza "".
Zastavica d doda m.indices: m.indices[0] je razpon celotnega ujemanja, m.indices[1] razpon prvega zajema, m.indices.groups.name pa razpon poimenovanega zajema. Vsak razpoložljiv par [start, end] uporablja položaje v enotah UTF-16 in ne vključuje end, zato ga lahko uporabiš neposredno v text.slice(start, end). Skupina, ki ni sodelovala, ima namesto para vrednost undefined; brez d lastnosti m.indices ni. Preveri, ali ciljno okolje podpira d in poimenovane skupine.
S standardnim RegExp vrne text.match(re) brez g enako vrsto rezultata kot exec(). Z g vrne le besedila celotnih ujemanj ali null, brez metapodatkov posameznih ujemanj. Če želiš pridobiti te metapodatke, iteriraj po text.matchAll(re) z zastavico g. Iterator uporablja kopijo regularnega izraza, ki prevzame trenutno vrednost re.lastIndex. Če znova uporabiš izraz z neničelnim lastIndex, lahko iterator preskoči prejšnja ujemanja. Za iskanje od začetka uporabi nov regularni izraz ali nastavi re.lastIndex = 0, preden pokličeš matchAll(). Če podaš RegExp brez g, se sproži TypeError.
Primeri
(() => {
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 zavzame dve kodni enoti UTF-16, presledek pa eno, zato se `id=42` začne na položaju `3`. Skupina `id` zajame niz `"42"` iz razpona `[6, 8]`; neobvezna skupina `unit` ne sodeluje pri ujemanju.
Povezane lekcije
- JavaScript · Lekcija 25 · Srednja · Različica: 3