Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Element.nextElementSibling — o elemento irmão seguinte

Element.nextElementSibling devolve o elemento seguinte mais próximo que tem o mesmo pai, ou null se não existir nenhum. Ignora nós de texto e comentários.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

element.nextElementSibling

Element.nextElementSibling é uma propriedade apenas de leitura, não um método: utiliza element.nextElementSibling sem parênteses. Devolve o elemento seguinte mais próximo que tem o mesmo pai, ou null se não existir nenhum.

Ao contrário de nextSibling, ignora nós de texto, incluindo espaços em branco, e comentários. Não procura entre os descendentes. Confirma que o resultado não é null antes de aceder às respetivas propriedades.

Esta é uma API do DOM, não uma funcionalidade do próprio ECMAScript; a presença do Node 24 não comprova a sua disponibilidade. O exemplo requer uma implementação do DOM que disponibilize document e as API do DOM utilizadas pelo código. Pode ser executado num navegador ou em Node.js com uma implementação do DOM como o jsdom. Não é necessário adicionar ao documento os elementos criados.

Exemplos

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);

Resultado

true
second
null

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes