CKTIS / JavaScript
Element.closest — antecessor correspondente mais próximo
Element.closest(selectors) verifica o elemento e, em seguida, os seus antecessores. Devolve o primeiro elemento correspondente ao seletor CSS, ou null.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.closest(selectors)Element.closest(selectors) é um método do DOM, não faz parte do próprio ECMAScript. Verifica primeiro o elemento onde é chamado e, depois, o respetivo pai e os antecessores seguintes. Devolve o Element correspondente mais próximo, ou null.
O argumento selectors é uma cadeia de caracteres com um seletor CSS. Uma sintaxe inválida lança uma DOMException com o nome SyntaxError, em vez de devolver null. O método não pesquisa entre os descendentes nem passa de uma árvore sombra para o respetivo anfitrião.
O exemplo verifica o antecessor correspondente mais próximo, a correspondência do próprio elemento e a ausência de correspondência. A árvore não tem de estar ligada ao documento.
Exemplos
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'));Resultado
true true null
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.