Método closest() do HTML DOM Element

Definição e uso

closest() O método busca elementos no DOM que coincidem com o seletor CSS especificado.

closest() O método começa no elemento em si, então são os pais (elemento pai, ancestral, ...), até encontrar o item correspondente.

Se não encontrar itens correspondentes, closest() O método retorna null.

Veja também:

Manual completo de seletores CSS

Método Element matches()

Exemplo

Exemplo 1

Encontre o elemento mais próximo que coincide com o seletor CSS ".container":

const element = document.getElementById("myElement");
const closest = element.closest(".container");

Experimente você mesmo

Exemplo 2

Encontre o elemento mais próximo que coincide com ".container" ou ".wrapper":

const element = document.getElementById(".container, .wrapper");
const closest = element.closest(".container");

Experimente você mesmo

Sintaxe

element.closest(selectors)

Parâmetros

Parâmetros Descrição
selectors

Obrigatório. Um ou mais (separados por vírgula) seletores CSS a serem correspondidos.

Veja nossa documentação completa Manual de referência de seletores CSS.

Retorno

Tipo Descrição
Objeto

O elemento ancestral mais próximo ou o elemento em si que coincide com o seletor CSS especificado.

Se não encontrar itens correspondentes, retornará null.

Se o seletor for inválido, será lançada a exceção SYNTAX_ERR.

Suporte do navegador

Primeiro suportado completamente closest() Versão do navegador do método:

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
Março de 2015 Abril de 2017 Janeiro de 2015 Outubro de 2015 Março de 2015