CKTIS / JavaScript
Node.contains — overenie príslušnosti k stromu DOM
Node.contains kontroluje, či je zadaný uzol samotným uzlom alebo jeho potomkom v ľubovoľnej hĺbke. Vráti logickú hodnotu.
Verzia: 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 je inštančná metóda rozhrania Node, ktorá sa volá ako node.contains(other). Vráti true, ak je other samotný node alebo jeho potomok v ľubovoľnej hĺbke; inak vráti false. Pre null je výsledok false.
Argument predstavuje uzol, nie CSS selektor ani hľadaný text. Potomkom môže byť aj textový uzol. Ak chcete vylúčiť samotný uzol, použite node !== other && node.contains(other).
Rozhodujúci je aktuálny strom DOM, nie viditeľnosť. Strom nemusí byť pripojený k dokumentu. Metóda neprekračuje hranice Shadow DOM: potomok vo vnútri shadow root preto nie je potomkom jeho hostiteľa. Ide o Web API štandardu DOM, nie o vlastnosť jazyka ECMAScript.
Prí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ýsledok
true true true false false false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.