Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes