CKTIS / JavaScript
RegExp.prototype.exec — съвпадения и групи за улавяне
RegExp.prototype.exec търси съвпадение и връща масив със съвпадналия текст и уловените групи или null. Флаговете g и y карат последователните извиквания да използват lastIndex и да актуализират стойността му.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
regexp.exec(string)regexp.exec(string) извършва съпоставяне с регулярен израз. Аргументът се преобразува в низ; вграденият метод изисква действителен екземпляр на RegExp като this. Резултатът е масив или null, а не булева стойност. Проверете резултата, преди да четете свойствата му.
match[0] съдържа цялото съвпадение, а match[1] и следващите елементи съдържат групите за улавяне. Група, която не е участвала в съвпадението, дава undefined. match.index е началната позиция в кодови единици на UTF-16, а match.input е низът, в който се търси. match.groups съдържа именуваните групи или undefined, ако шаблонът няма такива. Флагът d допълнително предоставя match.indices с двойки начало/край; краят не е включен.
Ако не е зададен нито g, нито y, търсенето започва от позиция 0 и оставя lastIndex непроменен. Ако е зададен поне един от двата флага, търсенето използва за отправна позиция резултата от прилагането на ToLength върху lastIndex (например 1.9 става 1). С g, но без y, търсенето може да провери по-късни позиции след неуспешен опит; с y не ги проверява. В режим Unicode (u или v), ако преобразуваната стойност на lastIndex сочи към втората кодова единица от сурогатна двойка в UTF-16, съвпадението може да започне от първата кодова единица на тази двойка. Затова дори с y върнатата стойност на match.index може да се различава от преобразуваната стойност на lastIndex. При успех lastIndex се задава на края на съвпадението, а при неуспех се нулира. Преди да използвате същия обект отново за независимо търсене, задайте lastIndex = 0.
В цикъл използвайте същия обект RegExp. Внимание: празното съвпадение не придвижва автоматично lastIndex; без изрично придвижване или прекъсване цикълът може никога да не приключи. Примерът използва шаблон, който винаги съвпада с поне един знак, и показва нулирането след последния неуспех.
Примери
const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);Резултат
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.