CKTIS / JavaScript
ResizeObserver.unobserve() — zakończenie obserwacji jednego elementu
Metoda unobserve(target) usuwa jeden element z obserwacji danego ResizeObserver, pozostawiając pozostałe cele bez zmian.
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)observer.unobserve(target) usuwa wskazany Element z listy celów tego obserwatora. Zwraca undefined. Przekaż sam element, nie selektor tekstowy.
Ponowne wywołanie dla nieobserwowanego elementu niczego nie zmienia. disconnect() usuwa natomiast wszystkie cele. Obserwację można wznowić przez observe(target).
Metoda nie usuwa elementu z dokumentu ani nie wycofuje wpisów już przekazanych do callbacku. Przydaje się przy sprzątaniu pojedynczego komponentu.
To API przeglądarkowe opisane w Resize Observer Module Level 1, nie funkcja ECMAScript. Obecność Node 24 nie potwierdza jego dostępności w przeglądarce; sprawdź środowisko docelowe.
Przykłady
(() => {
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);
})();Wynik
true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.