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