Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IntersectionObserver.observe — rozpoczęcie obserwacji elementu

Metoda observe(target) rejestruje element do asynchronicznego śledzenia przecięcia z obszarem root, używając konfiguracji obserwatora.

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

Składnia

observer.observe(target)

observer.observe(target) przyjmuje Element i zwraca undefined. Ponowna rejestracja tego samego elementu niczego nie zmienia. Jeden obserwator może śledzić wiele elementów; root, rootMargin i threshold ustawia się w konstruktorze, nie w observe().

Gdy przeglądarka po raz pierwszy sprawdza zarejestrowany element, dodaje do kolejki początkowy wpis, nawet jeśli nie ma przecięcia. Wpisy z kolejki są przekazywane do callbacku asynchronicznie, ale początkowy wpis nie musi do niego trafić: unobserve(target) może zakończyć obserwację, zanim wpis powstanie, a takeRecords() może usunąć go z kolejki, zanim zostanie przekazany. Przekroczenie progu lub zmiana isIntersecting może spowodować dodanie kolejnego wpisu do kolejki. Callback otrzymuje tablicę wpisów. Przecięcie geometryczne nie dowodzi faktycznej widoczności pikseli.

unobserve(target) zatrzymuje obserwację jednego elementu, a disconnect() wszystkich. To przeglądarkowe Web API, nie funkcja określonej edycji ECMAScript; sprawdź dostępność w docelowym środowisku. Sam Node 24 jej nie potwierdza.

Przykłady

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

Wynik

started
initial: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła