CKTIS / JavaScript
Node.parentElement — das direkte Elternelement
Node.parentElement gibt das direkte Elternelement vom Typ Element oder null zurück. Anders als parentNode gibt es weder Document noch DocumentFragment zurück.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
node.parentElementNode.parentElement ist eine schreibgeschützte DOM-Eigenschaft, keine Methode. Beim Auslesen von node.parentElement wird das direkte Elternelement zurückgegeben, sofern es vom Typ Element ist; andernfalls wird null zurückgegeben.
Die Eigenschaft funktioniert auch bei Textknoten. Sie sucht nicht nach einem weiter entfernten Vorfahren. parentNode kann ein Document oder DocumentFragment zurückgeben, während parentElement in diesen Fällen null zurückgibt.
Auch wenn kein Elternelement vorhanden ist, lautet der Wert null; prüfe das Ergebnis, bevor du weiter darauf zugreifst. Dass ein Knoten nicht mit dem Dokument verbunden ist, schließt ein Elternelement vom Typ Element nicht aus. Dies ist eine Web-API und keine Funktion der ECMAScript-Sprache; das Beispiel benötigt eine DOM-Umgebung.
Beispiele
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);Ergebnis
true true true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.