WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen