Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IntersectionObserver.unobserve — zakończenie obserwacji jednego elementu

Metoda unobserve(target) zatrzymuje obserwację wskazanego elementu przez dany IntersectionObserver, pozostawiając pozostałe elementy bez zmian. Nie usuwa już zakolejkowanych powiadomień.

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

IntersectionObserver.unobserve to metoda instancji wywoływana jako observer.unobserve(target). Argument target musi być elementem Element, nie selektorem. Metoda zwraca undefined; ponowne wywołanie dla nieobserwowanego elementu niczego nie zmienia.

unobserve(target) odłącza tylko wskazany element od tego obserwatora. disconnect() odłącza wszystkie jego elementy. Późniejsze observe(target) może rozpocząć obserwację ponownie. Typowe zastosowanie to zakończenie śledzenia po jednorazowym załadowaniu zawartości.

Powiadomienia są asynchroniczne: unobserve(target) nie usuwa już zakolejkowanych wpisów ani wpisów przekazanych do trwającego callbacku. takeRecords() pobiera i opróżnia całą kolejkę obserwatora, nie tylko wpisy danego elementu.

To przeglądarkowe Web API, nie funkcja określonej edycji ECMAScript. Sprawdź dostępność w docelowej przeglądarce; Node 24 w repozytorium nie potwierdza obsługi. Przykład synchronicznie rozpoczyna i kończy obserwację odłączonego elementu, bez zależności od przewijania.

Przykłady

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

Wynik

true
true
0

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

Źródła