Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

IntersectionObserver.observe — zahájení sledování prvku

Metoda observe(target) zaregistruje prvek pro asynchronní sledování jeho průniku s root podle konfigurace observeru.

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

Syntaxe

observer.observe(target)

observer.observe(target) přijímá Element a vrací undefined. Opětovná registrace stejného prvku nic nemění. Jeden observer může sledovat více prvků. root, rootMargin a threshold nastavte v konstruktoru, nikoli v observe().

Když prohlížeč poprvé vyhodnotí zaregistrovaný prvek, zařadí do fronty počáteční záznam, i když k průniku nedochází. Záznamy z fronty se callbacku předávají asynchronně, ale počáteční záznam se k němu nemusí dostat: unobserve(target) může zastavit sledování dříve, než záznam vznikne, a takeRecords() ho může z fronty odebrat před předáním. Překročení prahové hodnoty nebo změna isIntersecting může vést k zařazení dalšího záznamu do fronty. Callback dostává pole záznamů. Geometrický průnik nedokazuje, že jsou pixely skutečně viditelné.

unobserve(target) zastaví sledování jednoho prvku, zatímco disconnect() zastaví sledování všech. Jde o webové API prohlížeče, nikoli o funkci konkrétní edice ECMAScriptu. Dostupnost ověřte v cílovém prostředí. Samotný Node 24 podporu této funkce nepotvrzuje.

Příklady

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

Výsledek

started
initial: false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje