Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

RegExp.prototype.exec — shoda a zachytávací skupiny

RegExp.prototype.exec hledá shodu a vrací pole obsahující odpovídající text a zachycené skupiny, nebo null. Příznaky g a y způsobují, že následná volání používají lastIndex a aktualizují jeho hodnotu.

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

regexp.exec(string)

regexp.exec(string) provádí hledání regulárním výrazem. Argument se převede na řetězec; vestavěná metoda vyžaduje jako this skutečnou instanci RegExp. Výsledkem je pole nebo null, nikoli logická hodnota. Před čtením vlastností výsledek zkontrolujte.

match[0] obsahuje celou shodu a match[1] a další prvky obsahují zachytávací skupiny. Skupina, která se shody neúčastnila, má hodnotu undefined. match.index je počáteční pozice v jednotkách kódu UTF-16 a match.input je prohledávaný řetězec. match.groups obsahuje pojmenované skupiny, nebo undefined, pokud je vzor neobsahuje. Příznak d navíc zpřístupňuje match.indices s dvojicemi začátku a konce; konec je výlučný.

Bez g a y začíná hledání na pozici 0 a lastIndex zůstává nezměněný. Je-li nastaven alespoň jeden z těchto příznaků, hledání použije jako výchozí pozici výsledek operace ToLength nad hodnotou lastIndex (například z 1.9 vznikne 1). S g, ale bez y, může hledání po neúspěšném pokusu zkoušet další pozice; s y je nezkouší. Pokud v režimu Unicode (u nebo v) převedená hodnota lastIndex ukazuje na druhou jednotku náhradního páru UTF-16, může shoda začít na první jednotce tohoto páru. Proto se i s y může vrácená hodnota match.index od převedené hodnoty lastIndex lišit. Při úspěchu se lastIndex nastaví na konec shody, při neúspěchu se vynuluje. Před opětovným použitím objektu pro nezávislé hledání nastavte lastIndex = 0.

Ve smyčce používejte stále stejný objekt RegExp. Pozor: prázdná shoda automaticky neposune lastIndex; bez výslovného posunu nebo ukončení se smyčka nemusí nikdy zastavit. Příklad používá vzor, který vždy odpovídá alespoň jednomu znaku, a ukazuje vynulování po posledním neúspěchu.

Příklady

const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
  console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);

Výsledek

["x=12","x","12",0,4]
["y=7","y","7",5,8]
0

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.

Zdroje