CKTIS / JavaScript
Node.parentElement — o elemento pai imediato
Node.parentElement devolve o pai imediato se for do tipo Element, ou null. Ao contrário de parentNode, nunca devolve um objeto Document ou DocumentFragment.
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.parentElementNode.parentElement é uma propriedade DOM só de leitura, não um método. Ao ler node.parentElement, é devolvido o pai imediato se for do tipo Element; caso contrário, é devolvido null.
Também funciona em nós de texto. Não procura um antepassado mais distante. parentNode pode devolver um Document ou um DocumentFragment, enquanto parentElement devolve null nesses casos.
A ausência de um pai também significa null; verifica o resultado antes de qualquer acesso adicional. O facto de um nó estar desligado do documento não exclui a existência de um pai do tipo Element. Esta é uma API Web, não uma funcionalidade da linguagem ECMAScript; o exemplo requer um ambiente DOM.
Exemplos
const parent = document.createElement('section');
const text = document.createTextNode('Hello');
parent.appendChild(text);
console.log(text.parentElement === parent);
console.log(parent.parentElement === null);
const fragment = document.createDocumentFragment();
fragment.appendChild(parent);
console.log(parent.parentNode === fragment);
console.log(parent.parentElement === null);Resultado
true true true true
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.