Element: matches()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die matches()-Methode der Element-Schnittstelle testet, ob das Element durch den angegebenen CSS-Selektor ausgewählt würde.

Syntax

js
matches(selectors)

Parameter

selectors

Ein String, der gültige CSS-Selektoren enthält, um das Element zu testen.

Rückgabewert

true, wenn das Element die selectors erfüllt. Andernfalls false.

Ausnahmen

SyntaxError DOMException

Ausgelöst, wenn selectors nicht als CSS-Selektorliste geparst werden können.

Beispiele

HTML

html
<ul id="birds">
  <li>Orange-winged parrot</li>
  <li class="endangered">Philippine eagle</li>
  <li>Great white pelican</li>
</ul>

JavaScript

js
const birds = document.querySelectorAll("li");

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

Dies wird "Der Philippinenadler ist gefährdet!" in der Konsole ausgeben, da das Element tatsächlich ein class-Attribut mit dem Wert endangered hat.

Spezifikationen

Specification
DOM Standard
# ref-for-dom-element-matches①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch