CKTIS / JavaScript
IntersectionObserver.unobserve — ukončenie pozorovania jedného prvku
Metóda unobserve(target) zastaví pozorovanie určeného prvku daným IntersectionObserverom bez zmeny ostatných prvkov. Už zaradené oznámenia z frontu neodstráni.
Verzia: 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 je inštančná metóda, ktorá sa volá ako observer.unobserve(target). Argument target musí byť Element, nie selektor. Metóda vracia undefined; opakované zavolanie pre prvok, ktorý sa nepozoruje, nič nezmení.
unobserve(target) odpojí od tohto observera iba určený prvok. disconnect() odpojí všetky jeho prvky. Neskoršie volanie observe(target) môže pozorovanie znova spustiť. Typickým použitím je ukončiť sledovanie po jednorazovom načítaní obsahu.
Oznámenia sú asynchrónne: unobserve(target) neodstráni záznamy, ktoré už sú vo fronte, ani záznamy odovzdané práve spustenému callbacku. takeRecords() získa a vyprázdni celý front observera, nielen záznamy pre tento prvok.
Ide o webové API prehliadača, nie o funkciu konkrétnej edície ECMAScriptu. Overte dostupnosť v cieľovom prehliadači; Node 24 v repozitári podporu nepotvrdzuje. Príklad synchrónne začne a ukončí pozorovanie odpojeného prvku a nezávisí od posúvania stránky.
Prí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ýsledok
true true 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.