CKTIS / JavaScript
Element.closest — antenato corrispondente più vicino
Element.closest(selectors) controlla l’elemento e poi i suoi antenati. Restituisce il primo elemento che corrisponde al selettore CSS, oppure null.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.closest(selectors)Element.closest(selectors) è un metodo del DOM, non fa parte di ECMAScript in sé. Controlla prima l’elemento su cui viene chiamato, poi il suo genitore e gli antenati successivi. Restituisce l’Element corrispondente più vicino, oppure null.
L’argomento selectors è una stringa contenente un selettore CSS. Una sintassi non valida genera una DOMException denominata SyntaxError, invece di restituire null. Il metodo non cerca tra i discendenti e non passa da un albero ombra al relativo host.
L’esempio controlla l’antenato corrispondente più vicino, la corrispondenza dell’elemento stesso e l’assenza di corrispondenze. Non è necessario che l’albero sia collegato al documento.
Esempi
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'));Risultato
true true null
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.