Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Node.parentElement — l’elemento genitore immediato

Node.parentElement restituisce il genitore immediato se è di tipo Element, oppure null. A differenza di parentNode, non restituisce mai un oggetto Document o DocumentFragment.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

node.parentElement

Node.parentElement è una proprietà DOM di sola lettura, non un metodo. Leggendo node.parentElement si ottiene il genitore immediato se è di tipo Element; altrimenti si ottiene null.

La proprietà funziona anche sui nodi di testo. Non cerca un antenato più distante. parentNode può restituire un Document o un DocumentFragment, mentre parentElement in questi casi restituisce null.

Anche l’assenza di un genitore corrisponde a null; controlla il risultato prima di accedervi ulteriormente. Il fatto che un nodo sia scollegato dal documento non esclude che abbia un genitore di tipo Element. Questa è una Web API, non una funzionalità del linguaggio ECMAScript; l’esempio richiede un ambiente DOM.

Esempi

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);

Risultato

true
true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti