CKTIS / JavaScript
Element.matches — provjera CSS selektora
Element.matches provjerava odgovara li određeni element CSS selektoru. Vraća Booleovu vrijednost, a ne element; neispravna sintaksa selektora uzrokuje iznimku.
Verzija: 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) provjerava sam element. Argument selectors niz je CSS selektora ili popis selektora odvojenih zarezima. Rezultat je true ako element odgovara, a inače false.
Metoda ne pretražuje potomke kao querySelector() niti pronalazi odgovarajućeg pretka kao closest(). Element ne mora biti povezan s dokumentom; selektori koji ovise o odnosima u stablu ipak uzimaju u obzir njegovo stvarno okruženje.
Neispravan selektor uzrokuje DOMException s nazivom SyntaxError, umjesto da vrati false.
Ovo je DOM API definiran u DOM Standardu, a ne značajka ECMAScripta. Sama prisutnost Nodea 24 ne dokazuje da je ovaj API preglednika podržan.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.