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

CKTIS / JavaScript

`contains()` e `parentElement`: descendentes e pais diretos no DOM

`contains()` verifica se um nó é o próprio nó ou um dos seus descendentes. `parentElement` devolve o nó pai direto apenas se este for um elemento.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

container.contains(otherNode) // boolean; pass a Node or null
node.parentElement            // Element or null; read-only

container.contains(otherNode) devolve true se otherNode for o próprio container ou um descendente a qualquer profundidade, incluindo um nó de texto. Se receber null, devolve false. Omitir o argumento obrigatório ou passar uma cadeia de caracteres provoca um TypeError. Para excluir o próprio container, usa otherNode !== container && container.contains(otherNode).

node.parentElement é uma propriedade só de leitura, não um método. Devolve o nó pai direto se este for um Element. Devolve null se não houver nó pai ou se este for de outro tipo, como Document ou DocumentFragment. A propriedade não procura mais acima na árvore. Usa node.parentNode para obter o nó pai direto, independentemente do tipo.

Ambas as operações refletem a estrutura atual da árvore, mesmo quando esta não está ligada ao documento. Mover um nó pode alterar o resultado. Nenhuma passa da árvore shadow para o seu elemento anfitrião: para contains(), o anfitrião não contém os nós da sua árvore shadow, e o parentElement de um filho direto de um ShadowRoot é null.

Estes membros pertencem à interface Node do DOM e não à linguagem ECMAScript 2024. A sua disponibilidade depende de o ambiente de execução fornecer as APIs do DOM correspondentes.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>Node.contains() and Node.parentElement</title>
<script>
  const fragment = document.createDocumentFragment();
  const section = document.createElement("section");
  const span = document.createElement("span");
  const text = document.createTextNode("Hello");

  fragment.appendChild(section);
  section.appendChild(span);
  span.appendChild(text);

  console.log(`section.contains(text): ${section.contains(text)}`);
  console.log(`section.contains(section): ${section.contains(section)}`);
  console.log(`section.contains(null): ${section.contains(null)}`);
  console.log(`text.parentElement === span: ${text.parentElement === span}`);
  console.log(`section.parentElement: ${section.parentElement}`);
  console.log(`section.parentNode === fragment: ${section.parentNode === fragment}`);
</script>

Resultado

section.contains(text): true
section.contains(section): true
section.contains(null): false
text.parentElement === span: true
section.parentElement: null
section.parentNode === fragment: true

Guarda o exemplo num ficheiro `.html`, abre-o num navegador e verifica o resultado na consola de desenvolvimento. O fragmento que não está ligado ao documento contém `section`, mas não é um `Element`. Por isso, `section.parentElement` é `null`, embora `section.parentNode` seja o fragmento.

Lições relacionadas

  • JavaScript · Lição 18 · Avançado · Versão: 4

Fontes