Element : méthode matches()

Syntaxe

matches(selectors)

Paramètres

selectors

Une chaîne de caractères contenant des sélecteurs CSS valides pour tester le Element.

Valeur de retour

true si l'objet Element correspond aux selectors. Sinon, false.

Exceptions

SyntaxError DOMException

Levée si selectors ne peut pas être analysé comme une liste de sélecteurs CSS.

Exemples

HTML

<ul id="oiseaux">
  <li>Perroquet à ailes orange</li>
  <li class="disparition">Aigle des Philippines</li>
  <li>Grand pélican blanc</li>
</ul>

JavaScript

const oiseaux = document.querySelectorAll("li");

for (const oiseau of oiseaux) {
  if (oiseau.matches(".disparition")) {
    console.log(`Le ${oiseau.textContent} est en voie de disparition !`);
  }
}

Ça affiche « L'aigle des Philippines est en voie de disparition !» dans la console, puisque l'élément a effectivement un attribut class avec la valeur disparition.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Le module des sélecteurs CSS
• Les autres méthodes de Element qui utilisent des sélecteurs : Element.querySelector(), Element.querySelectorAll() et Element.closest().