CKTIS / JavaScript
IntersectionObserver.disconnect() : arrêter l’observation
disconnect() arrête l’observation de toutes les cibles d’un IntersectionObserver, tout en permettant de réutiliser 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.disconnect()observer.disconnect() retire toutes les cibles de cet observateur. La méthode ne prend aucun argument et renvoie undefined. Contrairement à unobserve(target), elle ne se limite pas à un seul élément. Les appels répétés sont sans danger ; un appel ultérieur à observe(target) relance l’observation.
La méthode ne vide pas les enregistrements déjà présents dans la file d’attente : une notification qui y a déjà été placée peut donc encore appeler le callback. Pour récupérer et vider les enregistrements en attente, utilisez takeRecords() ; traitez son résultat ou écartez-le délibérément. Appelez disconnect() lors du nettoyage d’un composant. Il s’agit d’une API Web, et non d’une fonctionnalité d’une édition particulière d’ECMAScript ; vérifiez la disponibilité de IntersectionObserver dans le navigateur cible.
Exemples
(() => {
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();
})();Résultat
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.