Zachytávací skupiny

Část vzoru můžeme uzavřít do závorek (...). Tato část se pak nazývá „zachytávací skupina“.

Má dva efekty:

1. Umožňuje nám získat část shody jako samostatný prvek pole výsledků.
2. Jestliže za závorky umístíme kvantifikátor, aplikuje se na závorky jako na celek.

Příklady

Na příkladech se podívejme, jak závorky fungují.

Příklad: gogogo

Vzor go+ bez závorek znamená znak g, po nÄ›mž následuje jednou nebo vícekrát opakované o, například goooo nebo gooooooooo.

Závorky seskupují znaky dohromady, takže (go)+ znamená go, gogo, gogogo a tak dále.

alert( 'Gogogo teď!'.match(/(go)+/ig) ); // "Gogogo"

Příklad: doména

Vytvořme něco složitějšího – regulární výraz pro hledání domény webového sídla.

Příklad:

mail.com
users.mail.com
smith.users.mail.com

Jak vidíme, doména se skládá z opakovaných slov a po každém z nich kromě posledního následuje tečka.

V regulárních výrazech to je (\w+\.)+\w+:

let rv = /(\w+\.)+\w+/g;

alert( "site.com my.site.com".match(rv) ); // site.com,my.site.com

Hledání funguje, ale vzor nenajde doménu s pomlčkou, napÅ™. my-site.com, protože pomlčka nepatří do třídy \w.

Můžeme to opravit nahrazením \w za [\w-] v každém slovÄ› kromÄ› posledního: ([\w-]+\.)+\w+.

Příklad: e-mail

Předchozí příklad můžeme rozšířit. Můžeme na jeho základě vytvořit regulární výraz pro e-maily.

Formát e-mailu je: jméno@doména. Jméno může být libovolné slovo, jsou povoleny i pomlčky a tečky. V regulárních výrazech to je [-.\w]+.

Vzor:

let rv = /[-.\w]+@([\w-]+\.)+[\w-]+/g;

alert("[email protected] @ [email protected]".match(rv)); // [email protected], [email protected]

Tento regulární výraz není dokonalý, ale většinou funguje a pomáhá opravovat neúmyslné překlepy. Jediná skutečně spolehlivá kontrola e-mailu je poslat na něj zprávu.

Obsah závorek ve shodě

Závorky jsou číslovány zleva doprava. Vyhledávací motor si pamatuje obsah každé z nich v nalezené shodě a umožňuje ho načíst ve výsledku.

Metoda řetězec.match(rv), pokud rv nemá příznak g, najde první shodu a vrátí ji jako pole:

1. Na indexu 0: celá shoda.
2. Na indexu 1: obsah prvních závorek.
3. Na indexu 2: obsah druhých závorek.
4. …a tak dále…

Například chceme najít HTML značky <.*?> a zpracovat je. Bylo by vhodné mít obsah značky (to, co je v lomených závorkách) v samostatné promÄ›nné.

UzavÅ™eme vnitÅ™ní obsah do závorek: <(.*?)>.

Nyní ve výsledném poli získáme jak značku jako celek <h1>, tak její obsah h1:

let řetězec = '<h1>Ahoj, světe!</h1>';

let značka = řetězec.match(/<(.*?)>/);

alert( značka[0] ); // <h1>
alert( značka[1] ); // h1

Vnořené skupiny

Závorky mohou být vnořené. I v takovém případě se číslují zleva doprava.

Například když hledáme značku ve <span class="moje">, může nás zajímat:

1. Obsah značky jako celek: span class="moje".
2. Název značky: span.
3. Atributy značky: class="moje".

PÅ™idejme pro nÄ› závorky: <(([a-z]+)\s*([^>]*))>.

Budou očíslovány následovně (zleva doprava podle otevírací závorky):

V akci:

let řetězec = '<span class="moje">';

let rv = /<(([a-z]+)\s*([^>]*))>/;

let výsledek = řetězec.match(rv);
alert(výsledek[0]); // <span class="moje">
alert(výsledek[1]); // span class="moje"
alert(výsledek[2]); // span
alert(výsledek[3]); // class="moje"

Nulový index pole výsledek obsahuje vždy celou shodu.

Pak následují skupiny, očíslované zleva doprava podle otevírací závorky. První skupina je vrácena ve výsledek[1]. V tomto případÄ› obsahuje celý obsah značky.

Pak výsledek[2] obsahuje skupinu ze druhé otevírací závorky ([a-z]+) – název značky, pak výsledek[3] obsahuje značku: ([^>]*).

Obsah každé skupiny v řetězci:

Nepovinné skupiny

I když je skupina nepovinná a ve shodÄ› se nevyskytuje (napÅ™. má kvantifikátor (...)?), odpovídající prvek pole výsledek bude přítomen a bude se rovnat undefined.

Uvažujme například regulární výraz a(z)?(c)?. Hledá "a", po nÄ›mž může následovat "z", po nÄ›mž může následovat "c".

Pokud jej spustíme na Å™etÄ›zci obsahujícím jediné písmeno a, výsledek bude:

let shoda = 'a'.match(/a(z)?(c)?/);

alert( shoda.length ); // 3
alert( shoda[0] ); // a (celá shoda)
alert( shoda[1] ); // undefined
alert( shoda[2] ); // undefined

Pole má délku 3, ale vÅ¡echny skupiny jsou prázdné.

A zde je složitÄ›jší shoda pro Å™etÄ›zec ac:

let shoda = 'ac'.match(/a(z)?(c)?/)

alert( shoda.length ); // 3
alert( shoda[0] ); // ac (celá shoda)
alert( shoda[1] ); // undefined, protože pro (z)? tam nic není
alert( shoda[2] ); // c

Délka pole je stále stejná: 3. Pro skupinu (z)? tam vÅ¡ak nic není, takže výsledek je ["ac", undefined, "c"].

Hledání všech shod se skupinami: matchAll

Když hledáme vÅ¡echny shody (příznak g), metoda match nevrací obsahy skupin.

Najděme například všechny značky v řetězci:

let řetězec = '<h1> <h2>';

let značky = řetězec.match(/<(.*?)>/g);

alert( značky ); // <h1>,<h2>

Výsledkem je pole shod, ale bez detailů o každé z nich. V praxi však zpravidla ve výsledku potřebujeme obsahy zachytávacích skupin.

Abychom je získali, mÄ›li bychom hledat metodou řetězec.matchAll(rv).

Byla do JavaScriptu pÅ™idána až dlouho po match jako její „nová a vylepÅ¡ená verze“.

Hledá shody stejnÄ› jako match, ale jsou tady 3 rozdíly:

1. Nevrací pole, ale iterovatelný objekt.
2. Pokud je uveden příznak g, vrací každou shodu jako pole se skupinami.
3. Nejsou-li žádné shody, nevrací null, ale prázdný iterovatelný objekt.

Příklad:

let výsledky = '<h1> <h2>'.matchAll(/<(.*?)>/gi);

// výsledky není pole, ale iterovatelný objekt
alert(výsledky); // [object RegExp String Iterator]

alert(výsledky[0]); // undefined (*)

výsledky = Array.from(výsledky); // změníme ho na pole

alert(výsledky[0]); // <h1>,h1 (1. značka)
alert(výsledky[1]); // <h2>,h2 (2. značka)

Jak vidíme, první rozdíl je velmi důležitý, jak je ukázáno na řádku (*). Nemůžeme načíst shodu jako výsledky[0], protože tento objekt je pseudopole. Můžeme z nÄ›j udÄ›lat opravdové Array pomocí Array.from. Další podrobnosti o pseudopolích a iterovatelných objektech naleznete v článku Iterovatelné objekty.

Pokud výsledky procházíme v cyklu, není Array.from nutné:

let výsledky = '<h1> <h2>'.matchAll(/<(.*?)>/gi);

for(let výsledek of výsledky) {
  alert(výsledek);
  // první alert: <h1>,h1
  // druhý: <h2>,h2
}

…Nebo při použití destrukturace:

let [značka1, značka2] = '<h1> <h2>'.matchAll(/<(.*?)>/gi);

Každá shoda, vrácená metodou matchAll, má stejný formát, jako by ji vrátila metoda match bez příznaku g: je to pole s dalšími vlastnostmi index (index shody v Å™etÄ›zci) a input (zdrojový Å™etÄ›zec):

let výsledky = '<h1> <h2>'.matchAll(/<(.*?)>/gi);

let [značka1, značka2] = výsledky;

alert( značka1[0] ); // <h1>
alert( značka1[1] ); // h1
alert( značka1.index ); // 0
alert( značka1.input ); // <h1> <h2>

Pojmenované skupiny

Pamatovat si skupiny podle čísel je těžké. U jednoduchých vzorů to dokážeme, ale u složitějších je počítání závorek nepraktické. Máme mnohem lepší možnost: pojmenovat závorky.

Učiníme to uvedením ?<jméno> hned za otevírací závorkou.

Hledejme například datum ve formátu „rok-měsíc-den“:

let rvDatum = /(?<rok>[0-9]{4})-(?<měsíc>[0-9]{2})-(?<den>[0-9]{2})/;
let řetězec = "2019-04-30";

let skupiny = řetězec.match(rvDatum).groups;

alert(skupiny.rok); // 2019
alert(skupiny.měsíc); // 04
alert(skupiny.den); // 30

Jak vidíte, skupiny se nacházejí ve vlastnosti shody .groups.

Chceme-li najít vÅ¡echna data, můžeme pÅ™idat příznak g.

PotÅ™ebujeme také matchAll k získání celých shod společnÄ› se skupinami:

let rvDatum = /(?<rok>[0-9]{4})-(?<měsíc>[0-9]{2})-(?<den>[0-9]{2})/g;

let řetězec = "2019-10-30 2020-01-01";

let výsledky = řetězec.matchAll(rvDatum);

for(let výsledek of výsledky) {
  let {rok, měsíc, den} = výsledek.groups;

  alert(`${den}.${měsíc}.${rok}`);
  // první alert: 30.10.2019
  // druhý: 01.01.2020
}

Zachytávací skupiny při nahrazování

Metoda řetězec.replace(rv, náhrada), která nahrazuje vÅ¡echny shody s regulárním výrazem rv v Å™etÄ›zci řetězec, umožňuje použít obsah závorek v Å™etÄ›zci náhrada. To se provádí pomocí $n, kde n je číslo skupiny.

Příklad:

let řetězec = "Jan Novak";
let rv = /(\w+) (\w+)/;

alert( řetězec.replace(rv, '$2, $1') ); // Novak, Jan

Odkaz na pojmenované závorky bude $<jméno>.

Například přeformátujme data z formátu „rok-měsíc-den“ na „den.měsíc.rok“:

let rv = /(?<rok>[0-9]{4})-(?<měsíc>[0-9]{2})-(?<den>[0-9]{2})/g;

let řetězec = "2019-10-30, 2020-01-01";

alert( řetězec.replace(rv, '$<den>.$<měsíc>.$<rok>') );
// 30.10.2019, 01.01.2020

Nezachytávací skupiny s ?:

Někdy potřebujeme závorky k tomu, abychom správně aplikovali kvantifikátor, ale jejich obsah nechceme mít ve výsledcích.

Skupinu můžeme vyloučit z výsledků uvedením ?: na jejím začátku.

Například když chceme najít (go)+, ale nechceme mít obsah závorek (go) jako samostatný prvek pole, můžeme napsat: (?:go)+.

V následujícím příkladu získáme jako samostatný prvek shody jedinÄ› jméno Jan:

let řetězec = "Gogogo Jan!";

// ?: vyloučí 'go' ze zachytávání
let rv = /(?:go)+ (\w+)/i;

let výsledek = řetězec.match(rv);

alert( výsledek[0] ); // Gogogo Jan (celá shoda)
alert( výsledek[1] ); // Jan
alert( výsledek.length ); // 2 (pole neobsahuje další prvky)

Shrnutí

Závorky seskupují dohromady část regulárního výrazu, takže kvantifikátor se na ně aplikuje jako na celek.

Závorkové skupiny jsou očíslovány zleva doprava a mohou být pojmenovány pomocí (?<jméno>...).

Obsah, kterému odpovídá skupina, můžeme získat ve výsledcích:

• Metoda řetězec.match vrací zachytávací skupiny jen bez příznaku g.
• Metoda řetězec.matchAll vrací zachytávací skupiny vždy.

Pokud závorky nemají jméno, je jejich obsah dostupný v poli shod podle jejich čísla. Pojmenované závorky jsou k dispozici i ve vlastnosti groups.

Obsah závorek můžeme použít i v nahrazovacím Å™etÄ›zci v metodÄ› řetězec.replace: podle čísla $n nebo jména $<jméno>.

Skupinu můžeme vyloučit z číslování uvedením ?: na jejím začátku. To používáme, když potÅ™ebujeme aplikovat kvantifikátor na celou skupinu, ale nechceme ji jako samostatný prvek v poli výsledků. Na takové závorky se také nemůžeme odkazovat v nahrazovacím Å™etÄ›zci.