CKTIS / JavaScript
Резултат от съвпадение с RegExp: `index` и `groups`
Виж откъде започва цялото съвпадение и какъв текст са прихванали именуваните групи. Флагът `d` дава и границите на диапазоните.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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) връща масив с резултата или null, ако няма съвпадение. Провери дали резултатът не е null, преди да четеш свойствата му. В масива m елементът m[0] съдържа цялото съвпадение. От m[1] нататък са прихванатите стойности, включително тези на именуваните групи, по реда на отварящите скоби. m.input съдържа целия входен низ.
m.index е началната позиция на цялото съвпадение, броена от нула в кодови единици UTF-16, дори с флага u. Това не е номер на група, нито re.lastIndex: при g или y регулярният израз пази в lastIndex позицията, от която започва следващото извикване на exec().
При група, записана като (?<name>...), прихванатият текст е достъпен чрез m.groups.name. Без именувани групи m.groups има стойност undefined; иначе е обект без прототип. Група, която не е участвала в съвпадението, има стойност undefined, а не празния низ "".
Флагът d добавя m.indices: m.indices[0] е диапазонът на цялото съвпадение, m.indices[1] е диапазонът на първата прихващаща група, а m.indices.groups.name — на именуваната група. Всяка налична двойка [start, end] използва позиции в единици UTF-16 и не включва end, затова може да се използва директно с text.slice(start, end). За група, която не е участвала, вместо двойка се получава undefined; без d свойството m.indices липсва. Провери дали целевата среда поддържа d и именувани групи.
При стандартен RegExp извикването text.match(re) без g дава същия вид резултат като exec(). С g то връща само текстовете на целите съвпадения или null, без метаданни за отделните съвпадения. За да получиш тези метаданни, обходи text.matchAll(re) с флага g. Итераторът използва копие на регулярния израз, което приема текущата стойност на re.lastIndex. Ако използваш повторно израз с ненулев lastIndex, итераторът може да пропусне по-ранни съвпадения. За да търсиш отначало, използвай нов регулярен израз или задай re.lastIndex = 0, преди да извикаш matchAll(). Подаването на RegExp без g предизвиква TypeError.
Примери
(() => {
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
}));
})();Резултат
{"match":"id=42","index":3,"id":"42","idRange":[6,8],"slicedId":"42","unitMissing":true}Емоджито заема две кодови единици UTF-16, а интервалът — една, затова `id=42` започва на позиция `3`. Групата `id` прихваща низа `"42"` от диапазона `[6, 8]`; незадължителната група `unit` не участва.
Свързани уроци
- JavaScript · Урок 25 · Средно · Версия: 3