CKTIS / JavaScript
Element.matches — overenie selektora CSS
Element.matches overuje, či daný prvok zodpovedá selektoru CSS. Vráti logickú hodnotu, nie prvok; neplatná syntax selektora vyvolá výnimku.
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
element.matches(selectors)element.matches(selectors) overuje samotný element. Argument selectors je reťazec so selektorom CSS alebo zoznam selektorov oddelených čiarkami. Výsledkom je true, ak prvok zodpovedá, inak false.
Metóda neprehľadáva potomkov ako querySelector() ani nenájde zodpovedajúceho predka ako closest(). Prvok nemusí byť pripojený k dokumentu; selektory závislé od vzťahov v strome však zohľadňujú jeho skutočné okolie.
Neplatný selektor vyvolá DOMException s názvom SyntaxError, namiesto toho, aby vrátil false.
Ide o DOM API definované v DOM Standard, nie o funkciu ECMAScriptu. Samotná prítomnosť Node 24 nedokazuje, že je toto rozhranie prehliadača podporované.
Prí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ýsledok
true false true SyntaxError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.