CKTIS / JavaScript
Element.closest — najbliži odgovarajući predak
Element.closest(selectors) provjerava element, a zatim njegove pretke. Vraća prvi element koji odgovara CSS selektoru ili null.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.closest(selectors)Element.closest(selectors) metoda je DOM-a, a ne samog ECMAScripta. Najprije provjerava element na kojem je pozvana, zatim njegov roditeljski element i sljedeće pretke. Vraća najbliži odgovarajući Element ili null.
Argument selectors niz je koji sadrži CSS selektor. Neispravna sintaksa izaziva DOMException naziva SyntaxError, umjesto da metoda vrati null. Metoda ne pretražuje potomke niti prelazi iz stabla sjene do njegova domaćina.
Primjer provjerava najbližeg odgovarajućeg pretka, podudaranje samog elementa i slučaj bez podudaranja. Stablo ne mora biti pridruženo dokumentu.
Primjeri
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'));Rezultat
true true null
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.