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.