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

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

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

Fontes