Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje