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

CKTIS / JavaScript

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

Методът unobserve(target) премахва един елемент от наблюдението на ResizeObserver, без да променя останалите му цели.

Версия: 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)

observer.unobserve(target) премахва посочения Element от списъка с цели на този наблюдател. Връща undefined. Подайте самия елемент, а не низ със селектор.

Повторното извикване за елемент, който не се наблюдава, не променя нищо. За разлика от него disconnect() премахва всички цели. Наблюдението може да се възобнови чрез observe(target).

Методът не премахва елемента от документа и не оттегля записи, които вече са предадени на callback функцията. Полезен е при почистване на отделен компонент.

Това е API на браузъра, описано в Resize Observer Module Level 1, а не функция на ECMAScript. Наличието на Node 24 не потвърждава, че API е достъпно в браузъра; проверете целевата среда.

Примери

(() => {
  const a = document.createElement('div');
  const b = document.createElement('div');
  for (const element of [a, b]) {
    element.style.cssText = 'display:block;width:100px;height:20px';
    document.body.append(element);
  }

  const observer = new ResizeObserver((entries) => {
    console.log(entries.length === 1 && entries[0].target === b);
    observer.disconnect();
    a.remove();
    b.remove();
  });

  observer.observe(a);
  observer.observe(b);
  observer.unobserve(a);
  observer.unobserve(a);
})();

Резултат

true

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

Източници