CKTIS / JavaScript
Node.contains — ověření příslušnosti ke stromu DOM
Node.contains kontroluje, zda je zadaný uzel samotným uzlem nebo jeho potomkem v libovolné hloubce. Vrací logickou hodnotu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.contains(other)Node.contains je instanční metoda rozhraní Node, která se volá jako node.contains(other). Vrací true, pokud je other samotný node nebo jeho potomek v libovolné hloubce; jinak vrací false. Pro null je výsledkem false.
Argument představuje uzel, nikoli CSS selektor nebo hledaný text. Potomkem může být také textový uzel. Chcete-li samotný uzel vyloučit, použijte node !== other && node.contains(other).
Rozhodující je aktuální strom DOM, nikoli viditelnost. Strom nemusí být připojený k dokumentu. Metoda nepřekračuje hranice Shadow DOM: potomek uvnitř shadow root proto není potomkem jeho hostitele. Jde o Web API standardu DOM, nikoli o vlastnost jazyka ECMAScript.
Příklady
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));Výsledek
true true true false false false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.