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.