CKTIS / JavaScript
Element.closest — най-близкият съвпадащ предшественик
Element.closest(selectors) проверява елемента, а след това и неговите предшественици. Връща първия елемент, който съвпада с CSS селектора, или null.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.closest(selectors)Element.closest(selectors) е метод на DOM, а не част от самия ECMAScript. Първо проверява елемента, върху който е извикан, след това неговия родител и следващите предшественици. Връща най-близкия съвпадащ Element или null.
Аргументът selectors е низ с CSS селектор. Невалиден синтаксис предизвиква DOMException с име SyntaxError, вместо методът да върне null. Методът не търси сред потомците и не преминава от shadow tree към неговия host.
Примерът проверява най-близкия съвпадащ предшественик, съвпадение със самия елемент и случай без съвпадение. Не е необходимо дървото да е прикрепено към документа.
Примери
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'));Резултат
true true null
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.