Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ResizeObserver.unobserve() — smettere di osservare un elemento

Il metodo unobserve(target) rimuove un elemento dalle osservazioni di un ResizeObserver, lasciando invariati gli altri target.

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)

observer.unobserve(target) rimuove l’Element specificato dall’elenco dei target di questo observer. Restituisce undefined. Passa l’elemento stesso, non una stringa di selettore.

Chiamarlo di nuovo per un elemento non osservato non cambia nulla. disconnect(), invece, rimuove tutti i target. È possibile riprendere l’osservazione con observe(target).

Il metodo non rimuove l’elemento dal documento e non ritira le voci già passate al callback. È utile quando si pulisce un singolo componente.

Questa è un’API del browser specificata in Resize Observer Module Level 1, non una funzionalità ECMAScript. La presenza di Node 24 non dimostra che sia disponibile nel browser; verifica l’ambiente di destinazione.

Esempi

(() => {
  const a = document.createElement('div');
  const b = document.createElement('div');
  for (const element of [a, b]) {
    element.style.cssText = 'display:block;width:100px;height:20px';
    document.body.append(element);
  }

  const observer = new ResizeObserver((entries) => {
    console.log(entries.length === 1 && entries[0].target === b);
    observer.disconnect();
    a.remove();
    b.remove();
  });

  observer.observe(a);
  observer.observe(b);
  observer.unobserve(a);
  observer.unobserve(a);
})();

Risultato

true

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