Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IntersectionObserver.disconnect(): interrompere l’osservazione

disconnect() interrompe l’osservazione di tutti gli elementi da parte di un IntersectionObserver, ma consente di riutilizzare l’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.disconnect()

observer.disconnect() rimuove tutti gli elementi dall’osservazione da parte di quell’observer. Non accetta argomenti e restituisce undefined. A differenza di unobserve(target), non si limita a un solo elemento. È sicuro chiamarlo più volte; una successiva chiamata a observe(target) avvia di nuovo l’osservazione.

Il metodo non svuota i record già presenti nella coda, quindi una notifica già accodata può ancora invocare il callback. Per recuperare e svuotare i record in sospeso, usa takeRecords(); elaborane il risultato oppure scartalo consapevolmente. Chiama disconnect() durante la pulizia di un componente. Questa è una Web API, non una funzionalità di una specifica edizione di ECMAScript; verifica che IntersectionObserver sia disponibile nel browser di destinazione.

Esempi

(() => {
  const targets = [document.createElement('div'), document.createElement('div')];
  const observer = new IntersectionObserver(() => {});

  targets.forEach(target => observer.observe(target));
  console.log(observer.disconnect() === undefined);
  observer.disconnect();
  console.log(observer.takeRecords().length);

  observer.observe(targets[0]);
  observer.disconnect();
})();

Risultato

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