CKTIS / JavaScript
String.prototype.match — zhody regulárneho výrazu
Metóda match() hľadá v reťazci zhody s regulárnym výrazom. Príznak g mení podobu výsledku: bez neho získate najviac jednu zhodu vrátane zachytených skupín, s ním pole úplných zhôd. Ak sa nič nezhoduje, výsledkom je null.
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.match(regexp)String.prototype.match hľadá v reťazci zhody so vzorom bez toho, aby reťazec menila. Pri štandardnom objekte RegExp je výsledkom pole alebo null, ak sa nič nezhoduje. Pred prístupom k prvkom výsledku skontrolujte, či výsledok nie je null.
Ak nie je nastavený ani g, ani y, metóda vráti prvú zhodu, ak existuje. S príznakom y, ale bez g, sa metóda pokúsi nájsť zhodu začínajúcu presne na pozícii získanej prevodom aktuálnej hodnoty lastIndex pomocou operácie ToLength. Môže teda vrátiť neskoršiu zhodu alebo vrátiť null, aj keď vzor zodpovedá inej časti reťazca. Napríklad /a/y s hodnotou lastIndex nastavenou na -1 nájde v reťazci 'a' zhodu na indexe 0. Ak sa nájde zhoda bez príznaku g, prvok 0 obsahuje celú zhodu a nasledujúce prvky obsahujú zachytené skupiny. Vlastnosť index udáva pozíciu zhody v kódových jednotkách UTF-16 a input obsahuje prehľadávaný reťazec. S príznakom g pole obsahuje úplné, neprekrývajúce sa zhody, ale neobsahuje zachytené skupiny ani tieto metadáta. Bez príznaku y môže vyhľadávanie preskočiť úseky medzi zhodami. Pri použití oboch príznakov, g a y, sa vyhľadávanie skončí, len čo na aktuálnej pozícii nenájde zhodu. Napríklad 'a a'.match(/a/gy) vráti iba ['a'], hoci na indexe 2 je ďalšie a. Ak chcete zachovať skupiny pri viacerých zhodách, použite matchAll().
Reťazcový argument sa interpretuje ako vzor regulárneho výrazu, nie ako doslovný text: "abc".match(".")[0] vytvorí "a". Vynechanie argumentu alebo odovzdanie hodnoty undefined vytvorí prázdny vzor, takže výsledkom je zhoda s prázdnym reťazcom, nie null.
Metóda technicky deleguje na Symbol.match, ak argument túto metódu poskytuje. Vlastná implementácia preto môže vrátiť iný typ výsledku; vyššie opísané správanie s poľom sa vzťahuje na štandardné správanie RegExp.
Príklady
const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));Výsledok
["item-12","12",0] ["item-12","item-34"] null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.