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

CKTIS / JavaScript

Element.previousElementSibling — elemento irmão anterior

A propriedade previousElementSibling devolve o elemento anterior mais próximo que tem o mesmo elemento-pai, ou null, ignorando 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.previousElementSibling

Element.previousElementSibling é uma propriedade só de leitura, não um método. Devolve o elemento anterior mais próximo que partilha o mesmo elemento-pai, ou null quando não existe nenhum. Isto também se aplica quando o elemento consultado não tem elemento-pai.

Ao contrário de previousSibling, ignora nós de texto e comentários. Não pesquisa antepassados nem descendentes. Confirme que o resultado não é null antes de o utilizar como elemento.

Esta é uma API do padrão DOM, não faz parte do próprio ECMAScript. É definida pelo mixin NonDocumentTypeChildNode, incluído em Element e CharacterData, mas não em DocumentType. O exemplo requer um ambiente DOM de navegador; a versão de Node.js do repositório não demonstra que esta API esteja disponível.

Exemplos

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

Resultado

true
true
true

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