Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła