Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori