CKTIS / JavaScript
Element.closest — ancêtre correspondant le plus proche
Element.closest(selectors) vérifie l’élément, puis ses ancêtres. La méthode renvoie le premier élément correspondant au sélecteur CSS, ou null.
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.closest(selectors)Element.closest(selectors) est une méthode du DOM, et non une partie d’ECMAScript lui-même. Elle vérifie d’abord l’élément sur lequel elle est appelée, puis son parent et ses ancêtres successifs. Elle renvoie l’Element correspondant le plus proche, ou null.
L’argument selectors est une chaîne contenant un sélecteur CSS. Une syntaxe invalide déclenche une DOMException nommée SyntaxError, au lieu de renvoyer null. La méthode ne recherche pas parmi les descendants et ne passe pas d’un arbre fantôme à son hôte.
L’exemple vérifie l’ancêtre correspondant le plus proche, une correspondance avec l’élément lui-même et l’absence de correspondance. Il n’est pas nécessaire que l’arbre soit rattaché au document.
Exemples
const outer = document.createElement('section');
const inner = document.createElement('div');
const button = document.createElement('button');
outer.className = 'panel';
inner.className = 'panel';
outer.append(inner);
inner.append(button);
console.log(button.closest('.panel') === inner);
console.log(button.closest('button') === button);
console.log(button.closest('.missing'));Résultat
true true 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.