Diematches() Methode desElement Interfaces prüft, ob das Element durch den angegebenenCSS-Selektor ausgewählt werden würde.

Syntax

matches(selectors)

Parameter

selectors

Ein String, der gültigeCSS-Selektoren enthält, um dasElement zu testen.

Rückgabewert

true, wenn dasElement denselectors entspricht. Andernfallsfalse.

Ausnahmen

SyntaxErrorDOMException

Wird ausgelöst, wennselectors nicht als Liste von CSS-Selektoren geparst werden kann.

Beispiele

HTML

<ul>  <li>Orange-winged parrot</li>  <li>Philippine eagle</li>  <li>Great white pelican</li></ul>

JavaScript

const birds = document.querySelectorAll("li");for (const bird of birds) {  if (bird.matches(".endangered")) {    console.log(`The ${bird.textContent} is endangered!`);  }}

Dies wird "The Philippine eagle is endangered!" in die Konsole ausgeben, da das Element tatsächlich einclass Attribut mit dem Wertendangered hat.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• CSS-Selektoren Modul
• AndereElement Methoden, die Selektoren verwenden:Element.querySelector(),Element.querySelectorAll(), undelement.closest().