KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen