Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Node.contains — sprawdzanie przynależności do drzewa DOM

Node.contains sprawdza, czy wskazany węzeł jest tym samym węzłem lub jego potomkiem na dowolnej głębokości. Zwraca wartość logiczną.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

node.contains(other)

Node.contains to metoda instancji Node, wywoływana jako node.contains(other). Zwraca true, gdy other jest samym node albo jego potomkiem na dowolnej głębokości; w przeciwnym razie zwraca false. Dla null wynikiem jest false.

Argument oznacza węzeł, nie selektor CSS ani tekst do wyszukania. Potomkiem może być również węzeł tekstowy. Aby wykluczyć sam węzeł, użyj node !== other && node.contains(other).

Liczy się aktualne drzewo DOM, nie widoczność. Drzewo nie musi być dołączone do dokumentu. Metoda nie przekracza granicy shadow DOM: potomek wewnątrz shadow root nie jest przez to potomkiem hosta. Jest to Web API standardu DOM, nie funkcja samego ECMAScript.

Przykłady

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));

Wynik

true
true
true
false
false
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła