Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.matches — verificare un selettore CSS

Element.matches verifica se un determinato elemento corrisponde a un selettore CSS. Restituisce un valore booleano, non un elemento; una sintassi del selettore non valida causa un’eccezione.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

element.matches(selectors)

element.matches(selectors) verifica element stesso. L’argomento selectors è una stringa di selettore CSS o un elenco di selettori separati da virgole. Il risultato è true se l’elemento corrisponde, altrimenti false.

Il metodo non cerca tra i discendenti come querySelector() né trova un antenato corrispondente come closest(). Non è necessario che l’elemento sia collegato a un documento; i selettori che dipendono dalle relazioni nell’albero tengono comunque conto del suo ambiente effettivo.

Un selettore non valido genera una DOMException denominata SyntaxError, invece di restituire false.

Questa è un’API DOM definita dal DOM Standard, non una funzionalità ECMAScript. La sola presenza di Node 24 non dimostra che questa API del browser sia supportata.

Esempi

const element = document.createElement('button');
element.className = 'action';

console.log(element.matches('button.action'));
console.log(element.matches('.missing'));
console.log(element.matches('.missing, .action'));

try {
  element.matches('[');
} catch (error) {
  console.log(error.name);
}

Risultato

true
false
true
SyntaxError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti