Thematches() method of theElement interface tests whether the element would be selected by the specifiedCSS selector.

Syntax

matches(selectors)

Parameters

selectors

A string containing validCSS selectors to test theElement against.

Return value

true if theElement matches theselectors. Otherwise,false.

Exceptions

SyntaxErrorDOMException

Thrown ifselectors cannot be parsed as a CSS selector list.

Examples

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!`);  }}

This will log "The Philippine eagle is endangered!" to the console, since the elementhas indeed aclass attribute with valueendangered.

Specifications

Browser compatibility

See also

• CSS selectors module
• OtherElement methods that take selectors:Element.querySelector(),Element.querySelectorAll(), andelement.closest().