Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wynik dopasowania RegExp: `index` i `groups`

Odczytaj pozycję całego dopasowania i tekst przechwycony przez nazwane grupy. Użyj flagi `d`, gdy potrzebujesz również zakresów pozycji.

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

Składnia

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) zwraca tablicę wyniku albo null, gdy nie ma dopasowania. Sprawdź, czy wynik nie jest null, zanim odczytasz jego właściwości. W tablicy m element m[0] zawiera całe dopasowanie, a m[1] i kolejne — wyniki grup przechwytujących, w tym nazwanych, w kolejności nawiasów otwierających. m.input zawiera cały przeszukiwany ciąg.

m.index to liczony od zera początek całego dopasowania w jednostkach kodowych UTF-16, nawet z flagą u. To nie numer grupy ani re.lastIndex: przy g lub y wyrażenie przechowuje w lastIndex pozycję, od której ma zacząć następne wywołanie exec().

Grupa (?<name>...) udostępnia przechwycony tekst jako m.groups.name. Bez nazwanych grup m.groups ma wartość undefined; w przeciwnym razie jest obiektem bez prototypu. Jeśli dana grupa nie uczestniczyła w dopasowaniu, jej wartość to undefined, a nie pusty ciąg "".

Flaga d dodaje m.indices: m.indices[0] to zakres całego dopasowania, m.indices[1] — pierwszej grupy przechwytującej, a m.indices.groups.name — grupy nazwanej. Każda dostępna para [start, end] zawiera początek i wyłączny koniec w jednostkach UTF-16, więc pasuje bezpośrednio do text.slice(start, end). Brak udziału grupy daje undefined zamiast pary; bez d właściwość m.indices nie istnieje. Sprawdź obsługę flagi d i nazwanych grup w docelowym środowisku.

Dla standardowego RegExp metoda text.match(re) bez g zwraca taki sam rodzaj wyniku jak exec(). Z g zwraca tylko teksty całych dopasowań albo null, bez metadanych poszczególnych dopasowań. Aby uzyskać te metadane, iteruj po text.matchAll(re) z flagą g. Iterator używa kopii wyrażenia z początkową wartością lastIndex pobraną z re.lastIndex, więc ponownie użyte wyrażenie z niezerowym lastIndex może pominąć wcześniejsze dopasowania. Aby szukać od początku, użyj nowego wyrażenia albo ustaw re.lastIndex = 0 przed wywołaniem matchAll(). Przekazanie RegExp bez g powoduje TypeError.

Przykłady

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

Wynik

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

Emoji zajmuje dwie jednostki kodowe UTF-16, a spacja jedną, więc `id=42` zaczyna się na pozycji `3`. Grupa `id` zawiera tekst `"42"` z zakresu `[6, 8]`; opcjonalna grupa `unit` nie uczestniczy w dopasowaniu.

Powiązane lekcje

  • JavaScript · Lekcja 25 · Średniozaawansowany · Wersja: 3

Źródła