Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Element.previousElementSibling — élément frère précédent

La propriété previousElementSibling renvoie l’élément précédent le plus proche ayant le même parent, ou null. Elle ignore les nœuds de texte et les commentaires.

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

Syntaxe

element.previousElementSibling

Element.previousElementSibling est une propriété en lecture seule, et non une méthode. Elle renvoie l’élément précédent le plus proche qui partage le même parent, ou null s’il n’en existe aucun. C’est également le cas lorsque l’élément interrogé n’a pas de parent.

Contrairement à previousSibling, elle ignore les nœuds de texte et les commentaires. Elle ne recherche ni parmi les ancêtres ni parmi les descendants. Vérifiez que le résultat n’est pas null avant de l’utiliser comme élément.

Il s’agit d’une API de la norme DOM, et non d’une partie d’ECMAScript lui-même. Elle est définie par le mixin NonDocumentTypeChildNode, inclus dans Element et CharacterData, mais pas dans DocumentType. L’exemple nécessite un environnement DOM de navigateur ; la version de Node.js du dépôt ne prouve pas que cette API est disponible.

Exemples

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

Résultat

true
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources