Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes