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 des Element-Interfaces prüft, ob das Element durch den angegebenen CSS-Selektor ausgewählt werden 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 den selectors entspricht. Andernfalls false.

Ausnahmen

SyntaxError DOMException

Wird ausgelöst, wenn selectors nicht als CSS-Selektor-Liste geparst werden kann.

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 "The Philippine eagle is endangered!" in die 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