CKTIS / JavaScript
IntersectionObserver.observe — commencer à observer un élément
La méthode observe(target) inscrit un élément pour suivre de façon asynchrone son intersection avec root, selon la configuration de l’observateur.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
observer.observe(target)observer.observe(target) accepte un Element et renvoie undefined. Inscrire à nouveau le même élément ne change rien. Un observateur peut suivre plusieurs éléments. Configurez root, rootMargin et threshold dans le constructeur, et non dans observe().
Lorsque le navigateur évalue la cible inscrite pour la première fois, il place une entrée initiale dans la file d’attente, même en l’absence d’intersection. Les entrées de la file sont transmises au callback de façon asynchrone, mais celui-ci ne reçoit pas forcément l’entrée initiale : unobserve(target) peut interrompre l’observation avant sa création, et takeRecords() peut la retirer de la file avant sa transmission. Le franchissement d’un seuil ou un changement de isIntersecting peut entraîner la mise en file d’attente d’une nouvelle entrée. Le callback reçoit un tableau d’entrées. Une intersection géométrique ne prouve pas que des pixels sont réellement visibles.
unobserve(target) arrête le suivi d’un élément, tandis que disconnect() l’arrête pour tous. Il s’agit d’une API Web du navigateur, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Vérifiez sa disponibilité dans l’environnement cible. Node 24 seul ne permet pas d’établir sa prise en charge.
Exemples
(() => {
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");
})();Résultat
started initial: false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.