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

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.

Fontes