CKTIS / JavaScript
IntersectionObserver.unobserve — prenehanje opazovanja enega elementa
Metoda unobserve(target) določenemu IntersectionObserverju prepreči nadaljnje opazovanje izbranega elementa, ne da bi spremenila njegove druge elemente. Obvestil, ki so že v čakalni vrsti, ne odstrani.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
observer.unobserve(target)IntersectionObserver.unobserve je instančna metoda, ki jo pokličemo kot observer.unobserve(target). Argument target mora biti Element, ne izbirnik. Metoda vrne undefined; ponovni klic za element, ki ga ne opazuje, ničesar ne spremeni.
unobserve(target) od tega opazovalnika odklopi samo izbrani element. disconnect() odklopi vse njegove elemente. Poznejši klic observe(target) lahko opazovanje znova začne. Pogosta uporaba je ustavitev spremljanja po enkratnem nalaganju vsebine.
Obvestila so asinhrona: unobserve(target) ne odstrani vnosov, ki so že v čakalni vrsti, niti vnosov, posredovanih trenutno izvajani funkciji callback. takeRecords() pridobi in izprazni celotno čakalno vrsto opazovalnika, ne le vnosov za ta element.
To je spletni API brskalnika, ne funkcija določene izdaje ECMAScripta. Preverite, ali je na voljo v ciljnem brskalniku; Node 24 v repozitoriju ne potrjuje podpore. Primer sinhrono začne in konča opazovanje odklopljenega elementa ter ni odvisen od drsenja.
Primeri
(() => {
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();
})();Rezultat
true true 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.