WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.previousElementSibling — vorheriges Geschwisterelement

Die Eigenschaft previousElementSibling gibt das nächstgelegene vorherige Element mit demselben Elternelement zurück oder null. Text und Kommentare werden übersprungen.

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

Syntax

element.previousElementSibling

Element.previousElementSibling ist eine schreibgeschützte Eigenschaft, keine Methode. Sie gibt das nächstgelegene vorherige Element zurück, das dasselbe Elternelement hat, oder null, wenn es keines gibt. Das gilt auch, wenn das abgefragte Element kein Elternelement hat.

Anders als previousSibling überspringt die Eigenschaft Textknoten und Kommentare. Sie durchsucht weder Vorfahren noch Nachfahren. Prüfe, ob das Ergebnis null ist, bevor du es als Element verwendest.

Dies ist eine API des DOM-Standards und kein Bestandteil von ECMAScript selbst. Sie wird vom Mixin NonDocumentTypeChildNode definiert, das in Element und CharacterData, aber nicht in DocumentType eingebunden ist. Das Beispiel benötigt eine DOM-Umgebung im Browser; die im Repository verwendete Node.js-Version belegt nicht, dass diese API verfügbar ist.

Beispiele

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

Ergebnis

true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen