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-onlycontainer.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