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

CKTIS / JavaScript

ResizeObserver.disconnect() — arrêter toutes les observations

La méthode disconnect() arrête l’observation de tous les éléments enregistrés auprès d’une instance de ResizeObserver. Elle ne détruit pas l’observateur : observe() peut relancer l’observation.

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() ne prend aucun argument et renvoie undefined. Elle efface la liste des éléments observés par cette instance et met fin à ses observations actives. Contrairement à unobserve(target), elle supprime toutes les observations, et pas seulement une.

Appelez-la lors du nettoyage d’un composant. La rappeler ne pose pas de problème ; vous pouvez ensuite utiliser observe(target). Elle n’interrompt pas un callback déjà en cours d’exécution.

L’exemple déconnecte l’observateur après la première notification, puis modifie la largeur. Un seul message est attendu : entries: 1. Cette API de navigateur est spécifiée dans Resize Observer Module Level 1, et non dans ECMAScript ; un environnement Node 24 ne permet pas d’établir sa disponibilité dans un navigateur.

Exemples

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'width:100px;height:20px;';
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    console.log('entries:', entries.length);
    observer.disconnect();
    box.style.width = '200px';
    requestAnimationFrame(() => box.remove());
  });

  observer.observe(box);
})();

Résultat

entries: 1

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