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

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.

Sources