WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Node.contains — Zugehörigkeit zum DOM-Baum prüfen

Node.contains prüft, ob ein bestimmter Knoten mit dem Knoten selbst identisch oder in beliebiger Tiefe ein Nachfahre davon ist. Die Methode gibt einen booleschen Wert zurück.

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

node.contains(other)

Node.contains ist eine Instanzmethode von Node und wird als node.contains(other) aufgerufen. Sie gibt true zurück, wenn other mit node identisch oder in beliebiger Tiefe ein Nachfahre davon ist; andernfalls gibt sie false zurück. Bei null ist das Ergebnis false.

Das Argument steht für einen Knoten, nicht für einen CSS-Selektor oder einen Suchtext. Auch ein Textknoten kann ein Nachfahre sein. Um den Knoten selbst auszuschließen, verwende node !== other && node.contains(other).

Entscheidend ist der aktuelle DOM-Baum, nicht die Sichtbarkeit. Der Baum muss nicht in das Dokument eingefügt sein. Die Methode überschreitet keine Shadow-DOM-Grenzen: Ein Nachfahre innerhalb eines Shadow Roots ist dadurch kein Nachfahre seines Hosts. Dies ist eine Web API des DOM-Standards und kein Sprachmerkmal von ECMAScript.

Beispiele

const root = document.createElement('div');
const child = document.createElement('span');
const text = document.createTextNode('Hello');
root.appendChild(child);
child.appendChild(text);

console.log(root.contains(root));
console.log(root.contains(child));
console.log(root.contains(text));
console.log(child.contains(root));
console.log(root.contains(null));
child.remove();
console.log(root.contains(text));

Ergebnis

true
true
true
false
false
false

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