CKTIS / JavaScript
Element.closest — nächster passender Vorfahr
Element.closest(selectors) prüft das Element und anschließend seine Vorfahren. Die Methode gibt das erste Element zurück, das zum CSS-Selektor passt, oder null.
Version: 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) ist eine DOM-Methode und nicht Teil von ECMAScript selbst. Sie prüft zuerst das aufrufende Element, danach dessen Elternteil und die weiteren Vorfahren. Zurückgegeben wird das nächstgelegene passende Element oder null.
Das Argument selectors ist eine Zeichenfolge mit einem CSS-Selektor. Eine ungültige Syntax löst eine DOMException mit dem Namen SyntaxError aus, statt null zurückzugeben. Die Methode durchsucht weder Nachfahren noch wechselt sie von einem Shadow Tree zu dessen Host.
Das Beispiel prüft den nächsten passenden Vorfahren, eine Übereinstimmung des Elements mit sich selbst und einen Fall ohne Übereinstimmung. Der Baum muss nicht in das Dokument eingefügt sein.
Beispiele
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'));Ergebnis
true true null
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.