CKTIS / JavaScript
Element.closest — najbližji ustrezni prednik
Element.closest(selectors) preveri element in nato njegove prednike. Vrne prvi element, ki ustreza izbirniku CSS, ali null.
Različica: 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) je metoda DOM-a, ne pa samega ECMAScripta. Najprej preveri element, na katerem je bila poklicana, nato njegovega starša in naslednje prednike. Vrne najbližji ustrezni Element ali null.
Argument selectors je niz z izbirnikom CSS. Neveljavna sintaksa sproži DOMException z imenom SyntaxError, namesto da bi metoda vrnila null. Metoda ne išče med potomci in ne preide iz senčnega drevesa do njegovega gostitelja.
Primer preveri najbližjega ustreznega prednika, ujemanje samega elementa in primer brez ujemanja. Drevesa ni treba pripeti dokumentu.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.