WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ResizeObserver.disconnect() — alle Beobachtungen beenden

Die Methode disconnect() beendet die Beobachtung aller Elemente, die bei einer ResizeObserver-Instanz registriert sind. Sie zerstört den Observer nicht: Mit observe() kann die Beobachtung erneut gestartet werden.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

observer.disconnect()

observer.disconnect() benötigt keine Argumente und gibt undefined zurück. Die Methode leert die Liste der von dieser Instanz beobachteten Elemente und beendet ihre aktiven Beobachtungen. Anders als unobserve(target) entfernt sie alle Beobachtungen, nicht nur eine.

Rufe die Methode beim Aufräumen einer Komponente auf. Ein erneuter Aufruf ist unbedenklich; anschließend kannst du wieder observe(target) verwenden. Einen Callback, der bereits ausgeführt wird, unterbricht sie nicht.

Das Beispiel trennt die Verbindung nach der ersten Benachrichtigung und ändert danach die Breite. Erwartet wird eine Meldung: entries: 1. Diese Browser-API ist im Resize Observer Module Level 1 spezifiziert, nicht in ECMAScript; eine Node-24-Umgebung belegt nicht, dass sie im Browser verfügbar ist.

Beispiele

(() => {
  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);
})();

Ergebnis

entries: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen