CKTIS / JavaScript
Element.matches — sprawdzanie dopasowania selektora CSS
Element.matches sprawdza, czy dany element pasuje do selektora CSS. Zwraca wartość logiczną, a nie element; niepoprawna składnia selektora powoduje wyjątek.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.matches(selectors)element.matches(selectors) sprawdza sam element. Argument selectors to tekst selektora CSS lub listy selektorów oddzielonych przecinkami. Wynik to true, jeśli element pasuje, albo false, jeśli nie pasuje.
Metoda nie wyszukuje potomków jak querySelector() i nie szuka pasującego przodka jak closest(). Element nie musi być dołączony do dokumentu; selektory zależne od relacji w drzewie uwzględniają jednak jego rzeczywiste otoczenie.
Niepoprawny selektor powoduje zgłoszenie DOMException o nazwie SyntaxError, zamiast zwrócenia false.
To API DOM zdefiniowane w DOM Standard, a nie funkcja ECMAScript. Sama obecność Node 24 nie dowodzi dostępności tego API przeglądarkowego.
Przykłady
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);
}Wynik
true false true SyntaxError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.