CKTIS / JavaScript
RegExp lastIndex — позиция на следващото съвпадение
lastIndex съхранява следващата позиция за търсене при регулярни изрази с флаг g или y. Това е записваемо свойство на всеки екземпляр на RegExp, а не свойство на прототипа.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
regexp.lastIndex
regexp.lastIndex = indexВъпреки наименованието RegExp.prototype.lastIndex, lastIndex е собствено свойство на всеки екземпляр на RegExp и първоначалната му стойност е 0. То е записваемо, неизброимо и неконфигурируемо. Позициите се броят в UTF-16 кодови единици, а не в знаци, възприемани от потребителя.
При вградените методи exec() и test() lastIndex служи като начална позиция за търсене с флаг g или y. С g без y съвпадението може да започне на по-късна позиция; с y по-късни позиции не се проверяват. В режим Unicode (u или v), ако lastIndex сочи към ниския сурогат на валидна сурогатна двойка в UTF-16, съвпадение с y може да започне от предхождащия го висок сурогат. При успех индексът се задава непосредствено след съвпадението; при неуспех се нулира, дори когато надвишава дължината на низа. Дори когато нито един от двата флага не е зададен, вграденият алгоритъм за търсене прочита lastIndex и прилага ToLength към стойността му. Ако преобразуването е успешно, алгоритъмът започва търсенето от 0 и не актуализира свойството. Ако стойността е от тип Symbol, преобразуването предизвиква изключение TypeError и търсенето не започва.
Можеш да присвоиш regexp.lastIndex = index; при използване стойността се преобразува чрез ToLength. Състоянието принадлежи на израза, а не на низа: преди независимо търсене задай lastIndex = 0 или създай друг екземпляр. Повтарящите се извиквания на test() с g или y също променят състоянието.
Празно съвпадение в exec() не придвижва автоматично индекса, затова наивен цикъл може никога да не приключи. Примерът използва непразни съвпадения и показва напредъка, нулирането след неуспех и ръчното продължаване.
Примери
const re = /a/g;
const text = "a_a";
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
re.lastIndex = 2;
console.log(re.exec(text).index, re.lastIndex);Резултат
true 1 true 3 false 0 2 3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.