Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ResizeObserver.unobserve() — ukončení sledování jednoho prvku

Metoda unobserve(target) odebere jeden prvek ze sledování daným ResizeObserverem a ostatní cíle ponechá beze změny.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

observer.unobserve(target)

observer.unobserve(target) odebere zadaný Element ze seznamu cílů tohoto observeru. Vrací undefined. Předejte samotný prvek, nikoli řetězec selektoru.

Opakované volání pro prvek, který se nesleduje, nic nezmění. Naproti tomu disconnect() odebere všechny cíle. Sledování lze obnovit pomocí observe(target).

Metoda prvek neodebere z dokumentu ani nestáhne záznamy, které už byly předány callbacku. Hodí se při úklidu jednotlivé komponenty.

Jde o API prohlížeče popsané ve specifikaci Resize Observer Module Level 1, nikoli o funkci ECMAScriptu. Samotná dostupnost Node 24 nepotvrzuje dostupnost v prohlížeči; ověřte cílové prostředí.

Příklady

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

Výsledek

true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje