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.