Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources