База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

IntersectionObserver.unobserve — спиране на наблюдението на един елемент

Методът unobserve(target) спира даден IntersectionObserver да наблюдава посочения елемент, без да променя останалите му елементи. Той не премахва известията, които вече са поставени на опашка.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

observer.unobserve(target)

IntersectionObserver.unobserve е метод на екземпляр и се извиква като observer.unobserve(target). Аргументът target трябва да бъде Element, а не селектор. Методът връща undefined; повторно извикване за елемент, който не се наблюдава, не променя нищо.

unobserve(target) отделя само посочения елемент от този observer. disconnect() отделя всички негови елементи. Последващо извикване на observe(target) може да започне наблюдението отново. Обичайна употреба е проследяването да се спре след еднократно зареждане на съдържание.

Известията са асинхронни: unobserve(target) не премахва вече поставените на опашка записи или записите, подадени на callback, който в момента се изпълнява. takeRecords() извлича и изпразва цялата опашка на observer-а, а не само записите за този елемент.

Това е Web API на браузъра, а не функция на конкретно издание на ECMAScript. Проверете наличността в целевия браузър; Node 24 в хранилището не доказва поддръжка. Примерът синхронно започва и спира наблюдението на отделен от документа елемент, без да зависи от превъртане.

Примери

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

Резултат

true
true
0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници