CKTIS / JavaScript
Node.contains — preverjanje pripadnosti drevesu DOM
Node.contains preveri, ali je podano vozlišče samo vozlišče ali njegov potomec na poljubni globini. Vrne logično vrednost.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
node.contains(other)Node.contains je instančna metoda vmesnika Node, ki jo pokličemo kot node.contains(other). Vrne true, kadar je other samo vozlišče node ali njegov potomec na poljubni globini; sicer vrne false. Za null je rezultat false.
Argument predstavlja vozlišče, ne izbirnika CSS ali besedila za iskanje. Potomec je lahko tudi besedilno vozlišče. Če želite izključiti samo vozlišče, uporabite node !== other && node.contains(other).
Pomembno je trenutno drevo DOM, ne vidnost. Drevesa ni treba pripeti dokumentu. Metoda ne prestopi meja Shadow DOM: potomec znotraj shadow root zato ni potomec njegovega gostitelja. To je spletni API standarda DOM, ne funkcija jezika ECMAScript.
Primeri
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));Rezultat
true true true false false false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.