Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.previousElementSibling — elemento fratello precedente

La proprietà previousElementSibling restituisce l’elemento precedente più vicino con lo stesso genitore, oppure null, ignorando nodi di testo e commenti.

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

Sintassi

element.previousElementSibling

Element.previousElementSibling è una proprietà di sola lettura, non un metodo. Restituisce l’elemento precedente più vicino che condivide lo stesso genitore, oppure null se non ne esiste uno. Questo vale anche quando l’elemento interrogato non ha un genitore.

A differenza di previousSibling, ignora i nodi di testo e i commenti. Non cerca tra gli antenati né tra i discendenti. Prima di usarlo come elemento, verifica che il risultato non sia null.

Questa è un’API dello standard DOM, non una parte di ECMAScript in sé. È definita dal mixin NonDocumentTypeChildNode, incluso in Element e CharacterData, ma non in DocumentType. L’esempio richiede un ambiente DOM del browser; la versione di Node.js nel repository non dimostra la disponibilità di questa API.

Esempi

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

Risultato

true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti