CKTIS / JavaScript
IntersectionObserver.observe — iniziare a osservare un elemento
Il metodo observe(target) registra un elemento per seguirne in modo asincrono l’intersezione con root, usando la configurazione dell’observer.
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
observer.observe(target)observer.observe(target) accetta un Element e restituisce undefined. Registrare di nuovo lo stesso elemento non cambia nulla. Un observer può seguire più elementi. Configura root, rootMargin e threshold nel costruttore, non in observe().
Quando il browser valuta per la prima volta l’elemento registrato, aggiunge alla coda una voce iniziale anche quando non c’è intersezione. Le voci in coda vengono passate al callback in modo asincrono, ma il callback potrebbe non ricevere la voce iniziale: unobserve(target) può interrompere l’osservazione prima che la voce venga generata e takeRecords() può rimuoverla dalla coda prima che venga passata al callback. Il passaggio sopra o sotto una soglia o una variazione di isIntersecting può far aggiungere una nuova voce alla coda. Il callback riceve un array di voci. Un’intersezione geometrica non dimostra che i pixel siano effettivamente visibili.
unobserve(target) interrompe il monitoraggio di un elemento; disconnect() lo interrompe per tutti. Questa è una Web API del browser, non una funzionalità di una specifica edizione di ECMAScript. Verifica la disponibilità nell’ambiente di destinazione. Node 24 da solo non ne dimostra il supporto.
Esempi
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver is unavailable");
}
const target = document.createElement("div");
target.style.display = "none";
document.body.append(target);
const observer = new IntersectionObserver((entries) => {
console.log("initial:", entries[0].isIntersecting);
observer.disconnect();
target.remove();
});
observer.observe(target);
observer.observe(target);
console.log("started");
})();Risultato
started initial: false
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.