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