Método closest() del objeto HTML DOM Element

Definición y uso

closest() El método busca elementos en el árbol DOM que coinciden con el selector CSS especificado.

closest() El método comienza en el elemento en sí mismo y luego en los antepasados (padre, abuelo, ...), hasta encontrar un elemento coincidente.

Si no se encuentra ningún elemento coincidente, closest() El método devuelve null.

Véase también:

Guía completa de selectores CSS

Método Element matches()

Ejemplo

Ejemplo 1

Encontrar el elemento más cercano que coincide con el selector CSS ".container":

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

Prueba personalmente

Ejemplo 2

Encontrar el elemento más cercano que coincide con ".container" o ".wrapper":

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

Prueba personalmente

Sintaxis

elemento.closest(selectors)

Parámetros

Parámetros Descripción
selectors

Obligatorio. Un o varios (separados por comas) selectores CSS a coincidir.

Consulte nuestra guía Manual de referencias de selectores CSS.

Valor de retorno

Tipo Descripción
Objeto

El elemento más cercano que coincide con el selector CSS especificado o el elemento en sí mismo.

Si no se encuentra ningún elemento coincidente, se devuelve null.

Si el selector es inválido, se lanza una excepción SYNTAX_ERR.

Compatibilidad del navegador

El primero en soportar completamente closest() Versión del navegador del método:

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
Marzo de 2015 Abril de 2017 Enero de 2015 Octubre de 2015 Marzo de 2015