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

CKTIS / JavaScript

IntersectionObserver.observe — começar a observar um elemento

O método observe(target) regista um elemento para acompanhar de forma assíncrona a sua interseção com root, usando a configuração do 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.observe(target)

observer.observe(target) aceita um Element e devolve undefined. Registar novamente o mesmo elemento não altera nada. Um observador pode acompanhar vários elementos. Configure root, rootMargin e threshold no construtor, não em observe().

Quando o navegador avalia pela primeira vez o elemento registado, coloca uma entrada inicial na fila, mesmo que não haja interseção. As entradas em fila são enviadas ao callback de forma assíncrona, mas este pode não receber a entrada inicial: unobserve(target) pode interromper a observação antes de a entrada ser gerada e takeRecords() pode retirá-la da fila antes de ser enviada. A passagem por um limiar ou uma alteração de isIntersecting pode levar à inclusão de uma nova entrada na fila. O callback recebe um array de entradas. Uma interseção geométrica não prova que os píxeis estejam realmente visíveis.

unobserve(target) interrompe o acompanhamento de um elemento; disconnect() interrompe-o para todos. Esta é uma Web API do navegador, não uma funcionalidade de uma edição específica de ECMAScript. Verifique a disponibilidade no ambiente de destino. O Node 24, por si só, não comprova o suporte.

Exemplos

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver is unavailable");
  }

  const target = document.createElement("div");
  target.style.display = "none";
  document.body.append(target);

  const observer = new IntersectionObserver((entries) => {
    console.log("initial:", entries[0].isIntersecting);
    observer.disconnect();
    target.remove();
  });

  observer.observe(target);
  observer.observe(target);
  console.log("started");
})();

Resultado

started
initial: false

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