CKTIS / JavaScript
RegExp — regulární výrazy
RegExp popisuje vzory pro vyhledávání v textu. Seznamte se s příznaky, skupinami, znakovými třídami, kvantifikátory a poli výsledku exec(), včetně pojmenovaných zachycení, rozsahů indexů a stavového chování lastIndex.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp představuje textový vzor. Vytvořte jej pomocí /pattern/flags nebo new RegExp("pattern", "flags"); řetězce konstruktoru vyžadují další úroveň escapování zpětných lomítek: /\d+/ odpovídá new RegExp("\\d+"). test() vrací logickou hodnotu; exec() vrací pole shody nebo null. Tento článek popisuje příznaky RegExp, skupiny, třídy, kvantifikátory a pole výsledku.
Příznaky: g umožňuje postupné shody, i ignoruje velikost písmen, m způsobí, že ^ a $ rozpoznají hranice řádků, s umožní . odpovídat ukončovacím znakům řádků, u zapne režim Unicode, v jej rozšíří o operace se znakovými množinami, y vyžaduje shodu přesně na pozici lastIndex a d přidá rozsahy indexů. u a v se vzájemně vylučují; duplicitní nebo neznámé příznaky způsobí SyntaxError.
Třídy jako [a-z], [^0-9] a \d vybírají znaky; \d označuje číslice ASCII. Skupiny (…) zachycují text, (?<name>…) pojmenuje zachycení a (?:…) nezachycuje. Kvantifikátory *, +, ? a {n,m} znamenají nula nebo více, jeden nebo více, nula nebo jeden a mezi n a m opakování. Ve výchozím nastavení jsou hladové; koncové ? je mění na líné.
Výsledek exec() obsahuje celou shodu na [0], zachycení od [1], počáteční pozici v index, původní text v input a pojmenovaná zachycení v groups, nebo undefined, pokud nejsou použity pojmenované skupiny. Zachycení bez shody mají hodnotu undefined. Pouze s příznakem d obsahuje pole shody také pole indices: indices[0] je dvojice indexů celé shody a další prvky obsahují dvojice pro příslušné zachytávací skupiny nebo undefined, pokud se daná skupina na shodě nepodílela. Každá dvojice vymezuje rozsah [start,end) (bez koncové pozice) v jednotkách kódu UTF-16, stejně jako index a lastIndex. Pokud vzor neobsahuje pojmenované zachytávací skupiny, má indices.groups hodnotu undefined. Jinak jde o objekt, který každému názvu skupiny přiřazuje její dvojici indexů nebo undefined, pokud se skupina na shodě nepodílela.
S příznakem g nebo y mění lastIndex jak exec(), tak test(): při úspěchu se nastaví na konec shody, při neúspěchu se vrátí na nulu. Prázdná shoda tuto hodnotu v exec() automaticky neposune, takže se cyklus nemusí ukončit. Pojmenované skupiny pocházejí z ES2018, d z ES2022 a v z ES2024. Jde o funkce ECMAScriptu, nikoli Web API; podporu v cílovém prohlížeči ověřte nezávisle na Node 24 v repozitáři.
Příklady
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
}));Výsledek
{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.