CKTIS / JavaScript
Element.closest — antecesor coincidente más cercana
Element.closest(selectors) comprueba el elemento y, a continuación, sus antecesores. Devuelve el primer elemento que coincide con el selector CSS, o null.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.closest(selectors)Element.closest(selectors) es un método del DOM, no forma parte de ECMAScript en sí. Primero comprueba el elemento sobre el que se llama y, después, su padre y los antecesores sucesivos. Devuelve el Element coincidente más cercano, o null.
El argumento selectors es una cadena con un selector CSS. Una sintaxis no válida provoca una DOMException llamada SyntaxError, en lugar de devolver null. El método no busca entre los descendientes ni pasa de un árbol de sombra a su host.
El ejemplo comprueba el antecesor coincidente más cercano, la coincidencia del propio elemento y la ausencia de coincidencias. No es necesario que el árbol esté conectado al documento.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.