CKTIS / JavaScript
String.prototype.matchAll — iterátor zhôd so zachytávacími skupinami
String.prototype.matchAll vracia iterátor zhôd regulárneho výrazu vrátane zachytávacích skupín a pozícií. Pri bežnom RegExp vyžaduje príznak g a lastIndex pôvodného vzoru zostane nezmenený.
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
string.matchAll(regexp)String.prototype.matchAll umožňuje prechádzať zhody vzoru v texte. Pri štandardnom správaní RegExp vracia lenivý iterátor: každý krok poskytne pole, ktorého [0] obsahuje celú zhodu a [1], [2] atď. zachytávacie skupiny. Nepovinná skupina bez zhody má hodnotu undefined. Vlastnosť index udáva pozíciu v jednotkách kódu UTF-16, input obsahuje vstupný text a groups sprístupňuje pomenované skupiny, ak existujú.
Ak je argument rozpoznaný ako regulárny výraz, matchAll skontroluje príznak g pred vyhľadaním Symbol.matchAll. Ak príznak chýba, volanie vyvolá TypeError. Vyhľadávanie zahŕňa aj zdedené vlastnosti: ak sa nájdená hodnota dá zavolať, matchAll ju zavolá a vráti jej výsledok. Ak vlastnosť chýba alebo má hodnotu undefined či null, matchAll z argumentu vytvorí RegExp s príznakom g. V tomto prípade sa reťazec použije ako vzor regulárneho výrazu, nie ako doslovný text. Každá iná hodnota Symbol.matchAll, ktorá sa nedá zavolať, vyvolá TypeError.
Štandardná implementácia RegExp vytvorí kópiu vzoru a jej počiatočnú hodnotu lastIndex nastaví na výsledok operácie ToLength použitej na lastIndex pôvodného vzoru. Napríklad z -1 vznikne 0 a z 2.9 vznikne 2. Hodnota lastIndex pôvodného vzoru zostáva nezmenená. Nepredpokladaj preto, že hľadanie sa vždy začína od nuly. Iterátor možno použiť iba raz: po vyčerpaní sa znova nespustí. Žiadne zhody znamenajú prázdnu iteráciu, nie null; výsledky spracuj pomocou for...of alebo ich ulož do poľa pomocou [...iterator].
Na rozdiel od match s príznakom g zachováva matchAll zachytávacie skupiny pre každú zhodu. Metóda patrí do ECMAScript 2020, nie do Web APIs. Samotná špecifikácia nepotvrdzuje podporu v konkrétnom prehliadači; nedokazuje ju ani prítomnosť Node 24 v repozitári. Dostupnosť v cieľovom prostredí možno overiť pomocou typeof String.prototype.matchAll === "function".
Príklady
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}`);Výsledok
x=12 | x | 12 | 0 y=7 | y | 7 | 5 lastIndex=0 remaining=0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.