CKTIS / JavaScript
IntersectionObserver.unobserve — arrêter d’observer un élément
La méthode unobserve(target) arrête un IntersectionObserver donné d’observer l’élément spécifié, sans modifier ses autres cibles. Elle ne supprime pas les notifications déjà placées dans la file d’attente.
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.unobserve(target)IntersectionObserver.unobserve est une méthode d’instance qui s’appelle ainsi : observer.unobserve(target). L’argument target doit être un Element, et non un sélecteur. La méthode renvoie undefined ; la rappeler pour un élément qui n’est pas observé ne change rien.
unobserve(target) détache uniquement l’élément spécifié de cet observateur. disconnect() détache toutes ses cibles. Un appel ultérieur à observe(target) peut démarrer à nouveau l’observation. Il est courant d’arrêter le suivi après le chargement d’un contenu unique.
Les notifications sont asynchrones : unobserve(target) ne supprime ni les entrées déjà placées dans la file d’attente ni celles transmises à un callback en cours d’exécution. takeRecords() récupère et vide toute la file de l’observateur, et pas seulement les entrées concernant cet élément.
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 le navigateur cible ; Node 24 dans le dépôt ne permet pas d’établir sa prise en charge. L’exemple démarre et arrête de façon synchrone l’observation d’un élément détaché, sans dépendre du défilement.
Exemples
(() => {
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();
})();Résultat
true true 0
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.