Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła