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

CKTIS / JavaScript

IntersectionObserver.unobserve — ukončení pozorování jednoho prvku

Metoda unobserve(target) zastaví pozorování určeného prvku daným IntersectionObserverem, aniž by změnila jeho ostatní prvky. Již zařazená oznámení z fronty neodstraní.

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

IntersectionObserver.unobserve je instanční metoda, která se volá jako observer.unobserve(target). Argument target musí být Element, nikoli selektor. Metoda vrací undefined; opakované zavolání pro prvek, který se nepozoruje, nic nezmění.

unobserve(target) odpojí od tohoto observeru pouze určený prvek. disconnect() odpojí všechny jeho prvky. Pozdější volání observe(target) může pozorování znovu spustit. Typickým použitím je ukončit sledování po jednorázovém načtení obsahu.

Oznámení jsou asynchronní: unobserve(target) neodstraní záznamy, které už jsou ve frontě, ani záznamy předané právě běžícímu callbacku. takeRecords() získá a vyprázdní celou frontu observeru, nikoli pouze záznamy pro tento prvek.

Jde o webové API prohlížeče, nikoli o funkci určité edice ECMAScriptu. Ověřte dostupnost v cílovém prohlížeči; Node 24 v repozitáři podporu nepotvrzuje. Příklad synchronně zahájí a ukončí pozorování odpojeného prvku a nezávisí na posouvání stránky.

Příklady

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

Výsledek

true
true
0

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