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