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

CKTIS / JavaScript

IntersectionObserver.disconnect(): parar a observação

disconnect() para a observação de todos os alvos por parte de um IntersectionObserver, mas permite reutilizar o observador.

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() remove todos os alvos da observação desse observador. Não recebe argumentos e devolve undefined. Ao contrário de unobserve(target), não se limita a um único elemento. É seguro chamar o método repetidamente; uma chamada posterior a observe(target) inicia novamente a observação.

O método não esvazia os registos que já estão na fila, pelo que uma notificação já colocada na fila ainda pode invocar o callback. Para obter e esvaziar os registos pendentes, utiliza takeRecords(); processa o resultado ou descarta-o deliberadamente. Chama disconnect() durante a limpeza de um componente. Esta é uma API Web, não uma funcionalidade de uma edição específica de ECMAScript; verifica se IntersectionObserver está disponível no navegador de destino.

Exemplos

(() => {
  const targets = [document.createElement('div'), document.createElement('div')];
  const observer = new IntersectionObserver(() => {});

  targets.forEach(target => observer.observe(target));
  console.log(observer.disconnect() === undefined);
  observer.disconnect();
  console.log(observer.takeRecords().length);

  observer.observe(targets[0]);
  observer.disconnect();
})();

Resultado

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