WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ResizeObserver.unobserve() — die Beobachtung eines Elements beenden

Die Methode unobserve(target) entfernt ein Element aus der Beobachtung durch einen ResizeObserver, während dessen übrige Ziele unverändert bleiben.

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.unobserve(target)

observer.unobserve(target) entfernt das angegebene Element aus der Zielliste dieses Observers. Die Methode gibt undefined zurück. Übergib das Element selbst, keine Selektor-Zeichenfolge.

Ein erneuter Aufruf für ein Element, das nicht beobachtet wird, bewirkt nichts. disconnect() entfernt dagegen alle Ziele. Mit observe(target) lässt sich die Beobachtung wieder aufnehmen.

Die Methode entfernt das Element weder aus dem Dokument noch zieht sie Einträge zurück, die bereits an den Callback übergeben wurden. Sie ist nützlich, wenn eine einzelne Komponente bereinigt wird.

Dies ist eine Browser-API aus dem Resize Observer Module Level 1 und keine ECMAScript-Funktion. Dass Node 24 vorhanden ist, belegt nicht die Verfügbarkeit im Browser; prüfe die Zielumgebung.

Beispiele

(() => {
  const a = document.createElement('div');
  const b = document.createElement('div');
  for (const element of [a, b]) {
    element.style.cssText = 'display:block;width:100px;height:20px';
    document.body.append(element);
  }

  const observer = new ResizeObserver((entries) => {
    console.log(entries.length === 1 && entries[0].target === b);
    observer.disconnect();
    a.remove();
    b.remove();
  });

  observer.observe(a);
  observer.observe(b);
  observer.unobserve(a);
  observer.unobserve(a);
})();

Ergebnis

true

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