Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources