CKTIS / JavaScript
RegExp — регулярни изрази
RegExp описва шаблони за търсене в текст. Научете за флаговете, групите, класовете от знаци, квантификаторите и полетата в резултата от exec(), включително именувани групи, диапазони от индекси и поведението на състоянието lastIndex.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp представя текстов шаблон. Създайте го с /pattern/flags или new RegExp("pattern", "flags"); низовете в конструктора изискват допълнително ниво на екраниране на обратните наклонени черти: /\d+/ съответства на new RegExp("\\d+"). test() връща булева стойност; exec() връща масив на съвпадението или null. Тази статия разглежда флаговете на RegExp, групите, класовете, квантификаторите и полетата на резултата.
Флагове: g позволява последователни съвпадения, i пренебрегва главни и малки букви, m кара ^ и $ да разпознават границите на редовете, s позволява на . да съвпада с терминатори на редове, u включва режим Unicode, v го разширява с операции върху множества от знаци, y изисква съвпадение точно при lastIndex, а d добавя диапазони от индекси. u и v са взаимно изключващи се; дублирани или непознати флагове причиняват SyntaxError.
Класове като [a-z], [^0-9] и \d избират знаци; \d означава ASCII цифри. Групите (…) улавят текст, (?<name>…) именува група, а (?:…) не улавя. Квантификаторите *, +, ? и {n,m} означават нула или повече, едно или повече, нула или едно и между n и m повторения. По подразбиране са алчни; завършващо ? ги прави лениви.
Резултатът от exec() съдържа цялото съвпадение при [0], групите от [1] нататък, началната позиция в index, оригиналния текст в input и именуваните групи в groups, или undefined, ако няма именувани групи. Групите без съвпадение имат стойност undefined. Само с флага d масивът на съвпадението съдържа масив indices: indices[0] е двойката индекси за цялото съвпадение, а следващите елементи съдържат двойките за съответните улавящи групи или undefined за групите, които не са участвали в съвпадението. Всяка двойка определя диапазон [start,end) (без крайната позиция) в кодови единици на UTF-16, каквито се използват и за index и lastIndex. Ако шаблонът няма именувани улавящи групи, indices.groups има стойност undefined. В противен случай това е обект, който свързва всяко име на група със съответната двойка индекси или с undefined, ако групата не е участвала в съвпадението.
При g или y и exec(), и test() променят lastIndex: при успех той се задава на края на съвпадението, а при неуспех се нулира. Празно съвпадение не го придвижва автоматично в exec(), затова цикълът може да не завърши. Именуваните групи са от ES2018, d — от ES2022, а v — от ES2024. Това са функции на ECMAScript, а не Web API; проверете поддръжката в целевия браузър независимо от Node 24 в хранилището.
Примери
const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
match: m[0],
captures: [m[1], m[2]],
key: m.groups.key,
index: m.index,
input: m.input,
span: m.indices[0],
keySpan: m.indices.groups.key,
lastIndex: re.lastIndex
}));Резултат
{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.