WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IntersectionObserver.unobserve — die Beobachtung eines Elements beenden

Die Methode unobserve(target) beendet die Beobachtung des angegebenen Elements durch einen bestimmten IntersectionObserver, ohne dessen andere Elemente zu beeinflussen. Bereits in die Warteschlange eingereihte Benachrichtigungen werden dadurch nicht entfernt.

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)

IntersectionObserver.unobserve ist eine Instanzmethode und wird als observer.unobserve(target) aufgerufen. Das Argument target muss ein Element sein, kein Selektor. Die Methode gibt undefined zurück; ein erneuter Aufruf für ein Element, das nicht beobachtet wird, ändert nichts.

unobserve(target) trennt nur das angegebene Element von diesem Observer. disconnect() trennt alle seine Elemente. Ein späterer Aufruf von observe(target) kann die Beobachtung erneut starten. Typischerweise wird die Beobachtung beendet, nachdem Inhalte einmalig geladen wurden.

Benachrichtigungen erfolgen asynchron: unobserve(target) entfernt weder bereits eingereihte Einträge noch Einträge, die an einen gerade laufenden Callback übergeben wurden. takeRecords() ruft die gesamte Warteschlange des Observers ab und leert sie, nicht nur Einträge für dieses Element.

Dies ist eine Web-API des Browsers und keine Funktion einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit im Zielbrowser; Node 24 im Repository belegt keine Unterstützung. Das Beispiel startet und beendet die Beobachtung eines abgetrennten Elements synchron und ist nicht vom Scrollen abhängig.

Beispiele

(() => {
  const target = document.createElement('div');
  const observer = new IntersectionObserver(() => {
    console.log('unexpected callback');
  });

  observer.observe(target);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.takeRecords().length);
  observer.disconnect();
})();

Ergebnis

true
true
0

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