CKTIS / JavaScript
String.prototype.matchAll — iterator podudaranja s grupama za hvatanje
String.prototype.matchAll vraća iterator podudaranja regularnog izraza, uključujući grupe za hvatanje i položaje. Kod uobičajenog RegExp-a potrebna je zastavica g, a lastIndex izvornog uzorka ostaje nepromijenjen.
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
string.matchAll(regexp)String.prototype.matchAll omogućuje prolazak kroz podudaranja uzorka u tekstu. Uz standardno ponašanje RegExp-a vraća lijeni iterator: svaki korak daje polje u kojem [0] sadrži cijelo podudaranje, a [1], [2] itd. grupe za hvatanje. Neobavezna grupa koja se ne podudara ima vrijednost undefined. Svojstvo index navodi položaj u UTF-16 kodnim jedinicama, input sadrži ulazni tekst, a groups izlaže imenovane grupe ako postoje.
Ako je argument prepoznat kao regularni izraz, matchAll provjerava zastavicu g prije traženja svojstva Symbol.matchAll. Ako zastavica nedostaje, poziv baca TypeError. Pretraga obuhvaća i naslijeđena svojstva: ako se pronađena vrijednost može pozvati, matchAll je poziva i vraća njezin rezultat. Ako svojstvo ne postoji ili mu je vrijednost undefined ili null, matchAll iz argumenta stvara RegExp sa zastavicom g. U tom se slučaju niz znakova tumači kao uzorak regularnog izraza, a ne kao doslovni tekst. Svaka druga vrijednost svojstva Symbol.matchAll koja se ne može pozvati uzrokuje TypeError.
Standardna implementacija RegExp-a stvara kopiju uzorka i kao početnu vrijednost njezina svojstva lastIndex postavlja rezultat primjene operacije ToLength na lastIndex izvornika. Primjerice, -1 postaje 0, a 2.9 postaje 2. Vrijednost lastIndex izvornika ostaje nepromijenjena. Zato nemoj pretpostaviti da pretraživanje uvijek počinje od nule. Iterator se može upotrijebiti samo jednom: nakon što se iscrpi, ne počinje ponovno. Ako nema podudaranja, iteracija je prazna, a ne null; upotrijebi for...of za obradu rezultata ili [...iterator] za njihovo spremanje u polje.
Za razliku od match sa zastavicom g, matchAll čuva grupe za hvatanje za svako podudaranje. Metoda pripada ECMAScriptu 2020, a ne Web API-jima. Sama specifikacija ne potvrđuje podršku u određenom pregledniku; to ne dokazuje ni prisutnost Nodea 24 u repozitoriju. Dostupnost u ciljnom okruženju može se provjeriti s typeof String.prototype.matchAll === "function".
Primjeri
const text = "x=12 y=7";
const pattern = /([a-z])=(\d+)/g;
const matches = text.matchAll(pattern);
for (const match of matches) {
console.log(`${match[0]} | ${match[1]} | ${match[2]} | ${match.index}`);
}
console.log(`lastIndex=${pattern.lastIndex}`);
console.log(`remaining=${[...matches].length}`);Rezultat
x=12 | x | 12 | 0 y=7 | y | 7 | 5 lastIndex=0 remaining=0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.