База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Node.contains — проверка за принадлежност към DOM дървото

Node.contains проверява дали даден възел е самият възел или негов наследник на произволна дълбочина. Методът връща булева стойност.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

node.contains(other)

Node.contains е инстанционен метод на Node, който се извиква като node.contains(other). Връща true, когато other е самият node или негов наследник на произволна дълбочина; в противен случай връща false. За null резултатът е false.

Аргументът обозначава възел, а не CSS селектор или текст за търсене. Наследник може да бъде и текстов възел. За да изключите самия възел, използвайте node !== other && node.contains(other).

От значение е текущото DOM дърво, а не видимостта. Дървото не е задължително да е прикрепено към документа. Методът не преминава границите на Shadow DOM: наследник вътре в shadow root не става поради това наследник на своя host. Това е Web API от стандарта DOM, а не функция на езика ECMAScript.

Примери

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

Резултат

true
true
true
false
false
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници