Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Element.previousElementSibling — elemento hermano anterior

La propiedad previousElementSibling devuelve el elemento anterior más cercano que comparte el mismo padre, o null; omite los nodos de texto y los comentarios.

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

Sintaxis

element.previousElementSibling

Element.previousElementSibling es una propiedad de solo lectura, no un método. Devuelve el elemento anterior más cercano que comparte el mismo padre, o null si no existe ninguno. Esto también ocurre cuando el elemento consultado no tiene padre.

A diferencia de previousSibling, omite los nodos de texto y los comentarios. No busca entre los antepasados ni entre los descendientes. Comprueba que el resultado no sea null antes de usarlo como elemento.

Esta es una API del estándar DOM, no forma parte de ECMAScript en sí. La define el mixin NonDocumentTypeChildNode, incluido en Element y CharacterData, pero no en DocumentType. El ejemplo requiere un entorno DOM de navegador; la versión de Node.js del repositorio no demuestra que esta API esté disponible.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes