CKTIS / JavaScript
Element.matches — preverjanje izbirnika CSS
Element.matches preveri, ali se določen element ujema z izbirnikom CSS. Vrne logično vrednost, ne elementa; neveljavna sintaksa izbirnika povzroči izjemo.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.matches(selectors)element.matches(selectors) preveri sam element. Argument selectors je niz izbirnika CSS ali seznam izbirnikov, ločenih z vejicami. Rezultat je true, če se element ujema, sicer false.
Metoda ne išče med potomci kot querySelector() in ne najde ujemajočega se prednika kot closest(). Elementu ni treba biti priključen dokumentu; izbirniki, ki so odvisni od odnosov v drevesu, pa upoštevajo njegovo dejansko okolico.
Neveljaven izbirnik sproži DOMException z imenom SyntaxError, namesto da bi vrnil false.
To je DOM API, določen v DOM Standard, in ne funkcija ECMAScript. Sama prisotnost Node 24 ne dokazuje, da je ta API brskalnika podprt.
Primeri
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);
}Rezultat
true false true SyntaxError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.