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.