База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници