Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

RegExp — regulárne výrazy

RegExp opisuje vzory na vyhľadávanie v texte. Zoznámte sa s príznakmi, skupinami, znakovými triedami, kvantifikátormi a poľami výsledku exec(), vrátane pomenovaných zachytení, rozsahov indexov a stavového správania lastIndex.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)

RegExp predstavuje textový vzor. Vytvorte ho pomocou /pattern/flags alebo new RegExp("pattern", "flags"); reťazce konštruktora vyžadujú ďalšiu úroveň escapovania spätných lomiek: /\d+/ zodpovedá new RegExp("\\d+"). test() vracia logickú hodnotu; exec() vracia pole zhody alebo null. Tento článok opisuje príznaky RegExp, skupiny, triedy, kvantifikátory a polia výsledku.

Príznaky: g umožňuje postupné zhody, i ignoruje veľkosť písmen, m spôsobí, že ^ a $ rozpoznajú hranice riadkov, s umožní . zodpovedať ukončovacím znakom riadkov, u zapne režim Unicode, v ho rozšíri o operácie so znakovými množinami, y vyžaduje zhodu presne na pozícii lastIndex a d pridá rozsahy indexov. u a v sa navzájom vylučujú; duplicitné alebo neznáme príznaky spôsobia SyntaxError.

Triedy ako [a-z], [^0-9] a \d vyberajú znaky; \d označuje číslice ASCII. Skupiny (…) zachytávajú text, (?<name>…) pomenuje zachytenie a (?:…) nezachytáva. Kvantifikátory *, +, ? a {n,m} znamenajú nula alebo viac, jeden alebo viac, nula alebo jeden a od n do m opakovaní. Predvolene sú chamtivé; koncové ? ich mení na lenivé.

Výsledok exec() obsahuje celú zhodu na [0], zachytenia od [1], počiatočnú pozíciu v index, pôvodný text v input a pomenované zachytenia v groups, alebo undefined, ak nie sú použité pomenované skupiny. Zachytenia bez zhody majú hodnotu undefined. Len s príznakom d obsahuje pole zhody aj pole indices: indices[0] je dvojica indexov celej zhody a ďalšie prvky obsahujú dvojice pre príslušné zachytávacie skupiny alebo undefined, ak sa daná skupina na zhode nepodieľala. Každá dvojica určuje rozsah [start,end) (bez koncovej pozície) v jednotkách kódu UTF-16, rovnako ako index a lastIndex. Ak vzor neobsahuje pomenované zachytávacie skupiny, indices.groups má hodnotu undefined. Inak je to objekt, ktorý každému názvu skupiny priraďuje jej dvojicu indexov alebo undefined, ak sa skupina na zhode nepodieľala.

S príznakom g alebo y menia lastIndex funkcie exec() aj test(): pri úspechu sa nastaví na koniec zhody, pri neúspechu sa vynuluje. Prázdna zhoda túto hodnotu v exec() automaticky neposunie, takže sa cyklus nemusí skončiť. Pomenované skupiny pochádzajú z ES2018, d z ES2022 a v z ES2024. Ide o funkcie ECMAScriptu, nie Web API; podporu v cieľovom prehliadači overte nezávisle od Node 24 v repozitári.

Prí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ýsledok

{"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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje