WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

IntersectionObserver.observe — ein Element beobachten

Die Methode observe(target) registriert ein Element für die asynchrone Verfolgung seiner Überschneidung mit root anhand der Konfiguration des Observers.

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

observer.observe(target) erwartet ein Element und gibt undefined zurück. Wird dasselbe Element erneut registriert, ändert sich dadurch nichts. Ein Observer kann mehrere Elemente verfolgen. root, rootMargin und threshold werden im Konstruktor festgelegt, nicht in observe().

Wenn der Browser das registrierte Zielelement zum ersten Mal prüft, reiht er auch dann einen ersten Eintrag ein, wenn keine Überschneidung vorliegt. Die Einträge aus der Warteschlange werden asynchron an den Callback übergeben, doch dieser erhält den ersten Eintrag nicht in jedem Fall: unobserve(target) kann die Beobachtung beenden, bevor der Eintrag erzeugt wird, und takeRecords() kann ihn vor der Übergabe aus der Warteschlange entfernen. Wird ein Schwellenwert über- oder unterschritten oder ändert sich isIntersecting, kann ein weiterer Eintrag eingereiht werden. Der Callback erhält ein Array von Einträgen. Eine geometrische Überschneidung beweist nicht, dass tatsächlich Pixel sichtbar sind.

unobserve(target) beendet die Beobachtung eines einzelnen Elements, disconnect() die aller Elemente. Dies ist eine Web API des Browsers und keine Funktion einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit in der Zielumgebung. Node 24 allein belegt keine Unterstützung.

Beispiele

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver is unavailable");
  }

  const target = document.createElement("div");
  target.style.display = "none";
  document.body.append(target);

  const observer = new IntersectionObserver((entries) => {
    console.log("initial:", entries[0].isIntersecting);
    observer.disconnect();
    target.remove();
  });

  observer.observe(target);
  observer.observe(target);
  console.log("started");
})();

Ergebnis

started
initial: false

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