CKTIS / JavaScript
IntersectionObserver.unobserve — deixar de observar um elemento
O método unobserve(target) faz com que um IntersectionObserver deixe de observar o elemento indicado, sem alterar os restantes elementos observados. Não remove as notificações que já estão na fila.
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.unobserve(target)IntersectionObserver.unobserve é um método de instância chamado como observer.unobserve(target). O argumento target tem de ser um Element, não um seletor. O método devolve undefined; chamá-lo novamente para um elemento que não está a ser observado não altera nada.
unobserve(target) desassocia apenas o elemento indicado deste observer. disconnect() desassocia todos os seus elementos. Uma chamada posterior a observe(target) pode iniciar novamente a observação. Uma utilização comum é parar o acompanhamento depois de carregar conteúdo uma única vez.
As notificações são assíncronas: unobserve(target) não remove as entradas que já estão na fila nem as que foram passadas a uma callback em execução. takeRecords() obtém e esvazia toda a fila do observer, e não apenas as entradas relativas a esse elemento.
Esta é uma API Web do browser, não uma funcionalidade de uma edição específica de ECMAScript. Verifica a disponibilidade no browser de destino; o Node 24 no repositório não comprova o suporte. O exemplo inicia e termina sincronicamente a observação de um elemento desligado, sem depender da deslocação da página.
Exemplos
(() => {
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();
})();Resultado
true true 0
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.