CKTIS / JavaScript
Element.closest — najbliższy pasujący przodek
Element.closest(selectors) sprawdza element, a następnie jego przodków. Zwraca pierwszy element pasujący do selektora CSS albo null.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.closest(selectors)Element.closest(selectors) to metoda DOM, nie samego ECMAScript. Zaczyna od elementu wywołującego, następnie sprawdza rodzica i kolejnych przodków. Zwraca najbliższy pasujący Element albo null.
Argument selectors jest ciągiem selektorów CSS. Niepoprawna składnia powoduje wyjątek DOMException o nazwie SyntaxError, nie wynik null. Metoda nie przeszukuje potomków ani nie przechodzi z drzewa cienia do jego hosta.
Przykład sprawdza najbliższego przodka, dopasowanie samego elementu i brak dopasowania. Drzewo nie musi być dołączone do dokumentu.
Przykłady
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'));Wynik
true true null
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.