Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri