CKTIS / JavaScript
String.prototype.match — shody regulárního výrazu
Metoda match() hledá v řetězci shody s regulárním výrazem. Příznak g mění podobu výsledku: bez něj dostanete nejvýše jednu shodu včetně zachycených skupin, s ním pole úplných shod. Pokud se nic neshoduje, výsledkem je null.
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
string.match(regexp)String.prototype.match hledá v řetězci shody se vzorem, aniž by řetězec měnila. U standardního objektu RegExp je výsledkem pole, nebo null, pokud se nic neshoduje. Než začnete přistupovat k prvkům výsledku, ověřte, že výsledek není null.
Není-li nastaven ani g, ani y, metoda vrátí první shodu, pokud existuje. S příznakem y, ale bez g, se metoda pokusí najít shodu začínající přesně na pozici získané převodem aktuální hodnoty lastIndex pomocí operace ToLength. Může tedy vrátit pozdější shodu nebo vrátit null, i když vzor odpovídá jinde v řetězci. Například /a/y s hodnotou lastIndex nastavenou na -1 najde v řetězci 'a' shodu na indexu 0. Při úspěšné shodě bez příznaku g prvek 0 obsahuje celou shodu a následující prvky obsahují zachycené skupiny. Vlastnost index udává pozici shody v kódových jednotkách UTF-16 a input obsahuje prohledávaný řetězec. S příznakem g pole obsahuje úplné, nepřekrývající se shody, ale neobsahuje zachycené skupiny ani tato metadata. Bez příznaku y může hledání přeskočit úseky mezi shodami. Při použití obou příznaků, g a y, hledání skončí, jakmile na aktuální pozici nenajde shodu. Například 'a a'.match(/a/gy) vrátí pouze ['a'], přestože na indexu 2 je další a. Chcete-li zachovat skupiny u více shod, použijte matchAll().
Řetězcový argument se interpretuje jako vzor regulárního výrazu, nikoli jako doslovný text: "abc".match(".")[0] vrátí "a". Vynechání argumentu nebo předání hodnoty undefined vytvoří prázdný vzor, takže výsledkem je shoda s prázdným řetězcem, nikoli null.
Metoda technicky deleguje na Symbol.match, pokud argument tuto metodu poskytuje. Vlastní implementace proto může vrátit jiný typ výsledku; výše popsané chování s polem se vztahuje na standardní chování RegExp.
Pří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ýsledek
["item-12","12",0] ["item-12","item-34"] null
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.