Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła