Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes