Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła