CKTIS / JavaScript
Node.contains — verificar a pertença à árvore DOM
Node.contains verifica se um nó indicado é o próprio nó ou um descendente a qualquer profundidade. Devolve um valor booleano.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
node.contains(other)Node.contains é um método de instância de Node, chamado como node.contains(other). Devolve true quando other é o próprio node ou um descendente a qualquer profundidade; caso contrário, devolve false. Para null, o resultado é false.
O argumento representa um nó, não um seletor CSS nem texto para pesquisar. Um nó de texto também pode ser um descendente. Para excluir o próprio nó, utiliza node !== other && node.contains(other).
O que conta é a árvore DOM atual, não a visibilidade. A árvore não tem de estar ligada ao documento. O método não atravessa os limites do Shadow DOM: um descendente dentro de um shadow root não passa, por isso, a ser descendente do respetivo host. Trata-se de uma Web API do padrão DOM, não de uma funcionalidade da linguagem ECMAScript.
Exemplos
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));Resultado
true true true false false false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.