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