Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti