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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.