CKTIS / JavaScript
Element.matches — einen CSS-Selektor prüfen
Element.matches prüft, ob ein bestimmtes Element einem CSS-Selektor entspricht. Die Methode gibt einen booleschen Wert und kein Element zurück; eine ungültige Selektorsyntax löst eine Ausnahme aus.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.matches(selectors)element.matches(selectors) prüft element selbst. Das Argument selectors ist eine CSS-Selektorzeichenfolge oder eine durch Kommas getrennte Selektorliste. Das Ergebnis ist true, wenn das Element passt, andernfalls false.
Die Methode durchsucht keine Nachfahren wie querySelector() und sucht auch keinen passenden Vorfahren wie closest(). Das Element muss nicht in ein Dokument eingefügt sein; Selektoren, die von Beziehungen im Baum abhängen, berücksichtigen jedoch seine tatsächliche Umgebung.
Ein ungültiger Selektor löst eine DOMException mit dem Namen SyntaxError aus, anstatt false zurückzugeben.
Dies ist eine in der DOM Standard definierte DOM-API und keine ECMAScript-Funktion. Dass Node 24 vorhanden ist, belegt allein nicht, dass diese Browser-API unterstützt wird.
Beispiele
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);
}Ergebnis
true false true SyntaxError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.