CKTIS / JavaScript
Element.closest — nejbližší odpovídající předek
Element.closest(selectors) kontroluje daný element a poté jeho předky. Vrátí první element odpovídající CSS selektoru, nebo null.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.closest(selectors)Element.closest(selectors) je metoda DOM, nikoli samotného ECMAScriptu. Nejprve zkontroluje element, na kterém je zavolána, a potom jeho rodiče a další předky. Vrátí nejbližší odpovídající Element, nebo null.
Argument selectors je řetězec s CSS selektorem. Neplatná syntaxe vyvolá DOMException s názvem SyntaxError, místo aby metoda vrátila null. Metoda neprohledává potomky ani nepřechází ze stínového stromu k jeho hostiteli.
Příklad kontroluje nejbližšího odpovídajícího předka, shodu samotného elementu a případ bez shody. Strom nemusí být připojený k dokumentu.
Příklady
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'));Výsledek
true true null
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.