CKTIS / JavaScript
Element.matches — ověření selektoru CSS
Element.matches ověřuje, zda daný prvek odpovídá selektoru CSS. Vrací logickou hodnotu, nikoli prvek; neplatná syntaxe selektoru vyvolá výjimku.
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
element.matches(selectors)element.matches(selectors) ověřuje samotný element. Argument selectors je řetězec se selektorem CSS nebo seznam selektorů oddělených čárkami. Výsledkem je true, pokud prvek odpovídá, jinak false.
Metoda neprohledává potomky jako querySelector() ani nenajde odpovídajícího předka jako closest(). Prvek nemusí být připojený k dokumentu; selektory závislé na vztazích ve stromu však berou v úvahu jeho skutečné okolí.
Neplatný selektor vyvolá DOMException s názvem SyntaxError, místo aby vrátil false.
Jde o DOM API definované v DOM Standard, nikoli o funkci ECMAScriptu. Samotná přítomnost Node 24 nedokazuje, že je toto rozhraní prohlížeče podporováno.
Příklady
const element = document.createElement('button');
element.className = 'action';
console.log(element.matches('button.action'));
console.log(element.matches('.missing'));
console.log(element.matches('.missing, .action'));
try {
element.matches('[');
} catch (error) {
console.log(error.name);
}Výsledek
true false true SyntaxError
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.