KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

RegExp-matchresultaten: `index` en `groups`

Lees waar de volledige match begint en welke tekst benoemde groepen hebben vastgelegd. Met de vlag `d` krijg je ook de begin- en eindposities.

Versie: 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) geeft een resultaatarray terug, of null als er geen match is. Controleer op null voordat je eigenschappen uitleest. In de array m bevat m[0] de volledige match. Vanaf m[1] volgen de vastgelegde teksten, ook die van benoemde groepen, in de volgorde van de openingshaakjes. m.input bevat de volledige invoertekst.

m.index is de beginpositie van de volledige match, geteld vanaf nul in UTF-16-code-eenheden, ook met de vlag u. Dit is geen groepsnummer en ook niet re.lastIndex: met g of y bewaart de reguliere expressie in lastIndex de positie waar de volgende aanroep van exec() begint.

Een groep die je schrijft als (?<name>...) maakt de vastgelegde tekst beschikbaar via m.groups.name. Zonder benoemde groepen is m.groups gelijk aan undefined; anders is het een object zonder prototype. Een groep die niet aan de match heeft deelgenomen, heeft undefined als waarde, niet de lege tekenreeks "".

De vlag d voegt m.indices toe: m.indices[0] geeft het bereik van de volledige match, m.indices[1] dat van de eerste groep en m.indices.groups.name dat van de benoemde groep. Elk beschikbaar paar [start, end] gebruikt UTF-16-posities en sluit end uit. Je kunt het dus direct gebruiken met text.slice(start, end). Een groep die niet heeft deelgenomen, krijgt undefined in plaats van een paar; zonder d ontbreekt de eigenschap m.indices. Controleer of je doelomgeving d en benoemde groepen ondersteunt.

Met een standaard-RegExp geeft text.match(re) zonder g hetzelfde soort resultaat als exec(). Met g geeft de methode alleen de volledige gematchte teksten of null, zonder metadata per match. Wil je die metadata uitlezen, itereer dan over text.matchAll(re) met g. De iterator gebruikt een kopie van de reguliere expressie die de huidige waarde van re.lastIndex overneemt. Hergebruik je een expressie waarvan lastIndex niet nul is, dan kunnen eerdere matches worden overgeslagen. Gebruik een nieuwe reguliere expressie of stel re.lastIndex = 0 in voordat je matchAll() aanroept om vanaf het begin te zoeken. Een RegExp zonder g veroorzaakt daarbij een TypeError.

Voorbeelden

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

Resultaat

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

De emoji neemt twee UTF-16-code-eenheden in en de spatie één. Daardoor begint `id=42` op positie `3`. De groep `id` legt de tekenreeks `"42"` vast uit `[6, 8]`; de optionele groep `unit` neemt niet deel.

Gerelateerde lessen

  • JavaScript · Les 25 · Gemiddeld · Versie: 3

Bronnen