Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

ResizeObserver.disconnect() — parar todas as observações

O método disconnect() deixa de observar todos os elementos registados numa instância de ResizeObserver. Não destrói o observador: observe() pode iniciar novamente a observação.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

observer.disconnect()

observer.disconnect() não aceita argumentos e devolve undefined. Limpa a lista de elementos observados por esta instância e termina as observações ativas. Ao contrário de unobserve(target), remove todas as observações, não apenas uma.

Chame-o durante a limpeza de um componente. Chamá-lo novamente é seguro; depois, pode usar observe(target). Não interrompe um callback que já esteja em execução.

O exemplo desliga o observador após a primeira notificação e, em seguida, altera a largura. É esperado um único registo: entries: 1. Esta API do navegador está especificada em Resize Observer Module Level 1, não em ECMAScript; um ambiente Node 24 não comprova a sua disponibilidade no navegador.

Exemplos

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'width:100px;height:20px;';
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    console.log('entries:', entries.length);
    observer.disconnect();
    box.style.width = '200px';
    requestAnimationFrame(() => box.remove());
  });

  observer.observe(box);
})();

Resultado

entries: 1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes