Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.previousElementSibling — poprzedni element rodzeństwa

Właściwość previousElementSibling zwraca najbliższy wcześniejszy element o tym samym rodzicu albo null, pomijając tekst i komentarze.

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

element.previousElementSibling

Element.previousElementSibling to właściwość tylko do odczytu, nie metoda. Zwraca najbliższy wcześniejszy element mający tego samego rodzica albo null, gdy takiego elementu nie ma, również gdy odczytywany element nie ma rodzica.

W przeciwieństwie do previousSibling pomija węzły tekstowe i komentarze. Nie przeszukuje przodków ani potomków. Przed użyciem wyniku jako elementu sprawdź, czy nie jest null.

To API standardu DOM, nie samego ECMAScript. Definiuje je miksin NonDocumentTypeChildNode, dołączany do Element i CharacterData, ale nie DocumentType. Przykład wymaga środowiska DOM w przeglądarce; wersja Node.js w repozytorium nie dowodzi dostępności tego API.

Przykłady

const parent = document.createElement('div');
const first = document.createElement('span');
const second = document.createElement('button');
parent.append(first, document.createTextNode(' '), document.createComment('gap'), second);

console.log(second.previousElementSibling === first);
console.log(second.previousSibling.nodeType === Node.COMMENT_NODE);
console.log(first.previousElementSibling === null);

Wynik

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