CKTIS / JavaScript
Node.parentElement — bezpośredni element nadrzędny
Node.parentElement zwraca bezpośredniego rodzica typu Element albo null. W przeciwieństwie do parentNode nie zwraca Document ani DocumentFragment.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
node.parentElementNode.parentElement to właściwość DOM tylko do odczytu, nie metoda. Odczyt node.parentElement zwraca bezpośredniego rodzica, jeśli jest on typu Element; w przeciwnym razie zwraca null.
Działa również dla węzłów tekstowych. Nie wyszukuje dalszego przodka. parentNode może zwrócić Document lub DocumentFragment, natomiast parentElement zwraca wtedy null.
Brak rodzica także oznacza null; przed dalszym dostępem sprawdź wynik. Odłączenie od dokumentu nie wyklucza rodzica typu Element. To Web API, a nie funkcja samego ECMAScript; przykład wymaga środowiska DOM.
Przykłady
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);Wynik
true true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.