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

CKTIS / JavaScript

Element.nextElementSibling — l’élément frère suivant

Element.nextElementSibling renvoie l’élément suivant le plus proche ayant le même parent, ou null s’il n’y en a pas. Les nœuds texte et les commentaires sont ignorés.

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

Element.nextElementSibling est une propriété en lecture seule, et non une méthode : utilisez element.nextElementSibling sans parenthèses. Elle renvoie l’élément suivant le plus proche ayant le même parent, ou null s’il n’y en a pas.

Contrairement à nextSibling, elle ignore les nœuds texte, y compris les espaces, ainsi que les commentaires. Elle ne recherche pas dans les descendants. Vérifiez que le résultat n’est pas null avant d’accéder à ses propriétés.

Il s’agit d’une API DOM, et non d’une fonctionnalité d’ECMAScript lui-même ; la présence de Node 24 ne prouve pas qu’elle soit disponible. L’exemple nécessite une implémentation du DOM qui fournit document et les API DOM utilisées par le code. Il peut s’exécuter dans un navigateur ou dans Node.js avec une implémentation du DOM comme jsdom. Il n’est pas nécessaire d’ajouter les éléments créés au document.

Exemples

const parent = document.createElement('div');
const first = document.createElement('span');
const second = document.createElement('span');
second.id = 'second';

parent.appendChild(first);
parent.appendChild(document.createTextNode('\n  '));
parent.appendChild(document.createComment('gap'));
parent.appendChild(second);

console.log(first.nextElementSibling === second);
console.log(first.nextElementSibling.id);
console.log(second.nextElementSibling);

Résultat

true
second
null

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