CKTIS / JavaScript
Element.matches — een CSS-selector testen
Element.matches test of een bepaald element overeenkomt met een CSS-selector. De methode retourneert een booleaanse waarde, geen element. Als de syntaxis van de selector ongeldig is, werpt de methode een uitzondering op.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.matches(selectors)element.matches(selectors) test element zelf. Het argument selectors is een CSS-selectorstring of een door komma’s gescheiden lijst met selectors. Het resultaat is true als het element overeenkomt, anders false.
De methode doorzoekt geen afstammelingen zoals querySelector() en vindt geen overeenkomende voorouder zoals closest(). Het element hoeft niet aan een document gekoppeld te zijn; selectors die afhankelijk zijn van relaties in de boomstructuur houden wel rekening met de daadwerkelijke omgeving.
Een ongeldige selector veroorzaakt een DOMException met de naam SyntaxError, in plaats van false te retourneren.
Dit is een DOM-API die is gedefinieerd door de DOM Standard, geen ECMAScript-functie. Alleen de aanwezigheid van Node 24 toont niet aan dat deze browser-API wordt ondersteund.
Voorbeelden
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);
}Resultaat
true false true SyntaxError
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.