Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

RegExp.prototype.exec — podudaranje i grupe za hvatanje

RegExp.prototype.exec traži podudaranje i vraća polje s podudarnim tekstom i uhvaćenim skupinama ili null. Zastavice g i y uzrokuju da uzastopni pozivi koriste lastIndex i ažuriraju njegovu vrijednost.

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

Sintaksa

regexp.exec(string)

regexp.exec(string) provodi podudaranje regularnim izrazom. Argument se pretvara u niz znakova; ugrađena metoda zahtijeva stvarnu instancu RegExp kao this. Rezultat je polje ili null, a ne Booleova vrijednost. Provjerite rezultat prije čitanja njegovih svojstava.

match[0] sadrži cijelo podudaranje, a match[1] i sljedeći elementi sadrže grupe za hvatanje. Grupa koja nije sudjelovala u podudaranju daje undefined. match.index početni je položaj u UTF-16 kodnim jedinicama, a match.input je pretraživani niz znakova. match.groups sadrži imenovane grupe ili undefined ako ih uzorak nema. Zastavica d dodatno omogućuje match.indices s parovima početka i kraja; kraj je isključiv.

Bez zastavica g i y pretraživanje počinje na položaju 0 i ne mijenja lastIndex. Ako je postavljena barem jedna od tih zastavica, pretraživanje kao polazni položaj uzima rezultat primjene operacije ToLength na vrijednost lastIndex (primjerice, 1.9 postaje 1). Uz g, ali bez y, pretraživanje nakon neuspjelog pokušaja može provjeriti kasnije položaje; uz y ih ne provjerava. Ako u načinu rada Unicode (u ili v) pretvorena vrijednost lastIndex pokazuje na drugu kodnu jedinicu zamjenskog para UTF-16, podudaranje može početi na prvoj kodnoj jedinici tog para. Stoga se i uz y vrijednost u match.index može razlikovati od pretvorene vrijednosti lastIndex. Uspjeh postavlja lastIndex na kraj podudaranja, a neuspjeh ga vraća na nulu. Prije ponovne upotrebe tog objekta za neovisno pretraživanje postavite lastIndex = 0.

U petlji koristite isti objekt RegExp. Upozorenje: prazno podudaranje ne pomiče automatski lastIndex; bez izričitog pomicanja ili prekida petlja možda nikada neće završiti. Primjer koristi uzorak koji uvijek odgovara barem jednom znaku i pokazuje vraćanje vrijednosti na nulu nakon posljednjeg neuspjeha.

Primjeri

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);

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori