CKTIS / JavaScript
Node.parentElement — l’élément parent immédiat
Node.parentElement renvoie le parent immédiat s’il est de type Element, ou null. Contrairement à parentNode, il ne renvoie jamais un objet Document ou DocumentFragment.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.parentElementNode.parentElement est une propriété DOM en lecture seule, et non une méthode. La lecture de node.parentElement renvoie le parent immédiat s’il est de type Element ; sinon, elle renvoie null.
Cette propriété fonctionne aussi sur les nœuds texte. Elle ne recherche pas un ancêtre plus éloigné. parentNode peut renvoyer un Document ou un DocumentFragment, tandis que parentElement renvoie null dans ces cas.
L’absence de parent signifie également null ; vérifiez le résultat avant tout accès supplémentaire. Le fait qu’un nœud soit déconnecté du document n’exclut pas qu’il ait un parent de type Element. Il s’agit d’une API Web, et non d’une fonctionnalité du langage ECMAScript ; l’exemple nécessite un environnement DOM.
Exemples
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);Résultat
true true true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.