Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.closest — najbližší zodpovedajúci predok

Element.closest(selectors) skontroluje daný element a potom jeho predkov. Vráti prvý element zodpovedajúci CSS selektoru alebo null.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.closest(selectors)

Element.closest(selectors) je metóda DOM, nie samotného ECMAScriptu. Najprv skontroluje element, na ktorom sa zavolá, potom jeho rodiča a ďalších predkov. Vráti najbližší zodpovedajúci Element alebo null.

Argument selectors je reťazec s CSS selektorom. Neplatná syntax vyvolá DOMException s názvom SyntaxError, namiesto toho, aby metóda vrátila null. Metóda nevyhľadáva medzi potomkami ani neprechádza z tieňového stromu k jeho hostiteľovi.

Príklad kontroluje najbližšieho zodpovedajúceho predka, zhodu samotného elementu a prípad bez zhody. Strom nemusí byť pripojený k dokumentu.

Prí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ýsledok

true
true
null

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje