Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IntersectionObserver.unobserve — interrompere l’osservazione di un elemento

Il metodo unobserve(target) fa sì che uno specifico IntersectionObserver smetta di osservare l’elemento indicato, senza modificare gli altri elementi osservati. Non rimuove le notifiche già accodate.

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.unobserve(target)

IntersectionObserver.unobserve è un metodo di istanza e si chiama come observer.unobserve(target). L’argomento target deve essere un Element, non un selettore. Il metodo restituisce undefined; richiamarlo per un elemento che non è osservato non cambia nulla.

unobserve(target) scollega da questo observer solo l’elemento indicato. disconnect() scollega tutti i suoi elementi. Una successiva chiamata a observe(target) può avviare di nuovo l’osservazione. Un uso tipico consiste nell’interrompere il monitoraggio dopo aver caricato contenuti una sola volta.

Le notifiche sono asincrone: unobserve(target) non rimuove le voci già accodate né quelle passate a una callback attualmente in esecuzione. takeRecords() recupera e svuota l’intera coda dell’observer, non solo le voci relative a quell’elemento.

Questa è un’API Web del browser, non una funzionalità di una specifica edizione di ECMAScript. Verifica la disponibilità nel browser di destinazione; Node 24 nel repository non dimostra che sia supportata. L’esempio avvia e interrompe sincronicamente l’osservazione di un elemento scollegato, senza dipendere dallo scorrimento.

Esempi

(() => {
  const target = document.createElement('div');
  const observer = new IntersectionObserver(() => {
    console.log('unexpected callback');
  });

  observer.observe(target);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.takeRecords().length);
  observer.disconnect();
})();

Risultato

true
true
0

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