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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

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
# ref-for-dom-element-matches①

Browser-Kompatibilität

Siehe auch