CKTIS / JavaScript
Element.nextElementSibling — następny element rodzeństwa
Element.nextElementSibling zwraca najbliższy kolejny element mający tego samego rodzica albo null. Pomija węzły tekstowe 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.nextElementSiblingElement.nextElementSibling to właściwość tylko do odczytu, nie metoda: używaj element.nextElementSibling bez nawiasów. Zwraca najbliższy kolejny element mający tego samego rodzica albo null, gdy takiego elementu nie ma.
W przeciwieństwie do nextSibling pomija węzły tekstowe, w tym białe znaki, oraz komentarze. Nie wyszukuje potomków. Przed użyciem właściwości wyniku sprawdź, czy wynik nie jest null.
To API DOM, a nie funkcja samego ECMAScript; obecność Node 24 nie dowodzi jego dostępności. Przykład wymaga implementacji DOM, która udostępnia document i używane w kodzie API. Można go uruchomić w przeglądarce lub w Node.js z implementacją DOM, taką jak jsdom. Utworzonych elementów nie trzeba dołączać do dokumentu.
Przykłady
const parent = document.createElement('div');
const first = document.createElement('span');
const second = document.createElement('span');
second.id = 'second';
parent.appendChild(first);
parent.appendChild(document.createTextNode('\n '));
parent.appendChild(document.createComment('gap'));
parent.appendChild(second);
console.log(first.nextElementSibling === second);
console.log(first.nextElementSibling.id);
console.log(second.nextElementSibling);Wynik
true second null
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.