Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje