KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.closest — dichtstbijzijnde overeenkomende voorouder

Element.closest(selectors) controleert het element en daarna diens voorouders. De methode retourneert het eerste element dat overeenkomt met de CSS-selector, of null.

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.closest(selectors)

Element.closest(selectors) is een DOM-methode en maakt geen deel uit van ECMAScript zelf. De methode controleert eerst het element waarop ze wordt aangeroepen, daarna het bovenliggende element en de daaropvolgende voorouders. Ze retourneert het dichtstbijzijnde overeenkomende Element, of null.

Het argument selectors is een tekenreeks met een CSS-selector. Ongeldige syntaxis veroorzaakt een DOMException met de naam SyntaxError, in plaats van null te retourneren. De methode doorzoekt geen onderliggende elementen en gaat niet vanuit een shadow tree naar de host ervan.

Het voorbeeld controleert de dichtstbijzijnde overeenkomende voorouder, een overeenkomst met het element zelf en het ontbreken van een overeenkomst. De boom hoeft niet aan het document te zijn gekoppeld.

Voorbeelden

const outer = document.createElement('section');
const inner = document.createElement('div');
const button = document.createElement('button');
outer.className = 'panel';
inner.className = 'panel';
outer.append(inner);
inner.append(button);

console.log(button.closest('.panel') === inner);
console.log(button.closest('button') === button);
console.log(button.closest('.missing'));

Resultaat

true
true
null

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