CKTIS / JavaScript
ResizeObserver.unobserve() — dejar de observar un elemento
El método unobserve(target) elimina un elemento de las observaciones de un ResizeObserver y deja sin cambios los demás objetivos.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
observer.unobserve(target)observer.unobserve(target) elimina el Element especificado de la lista de objetivos de este observador. Devuelve undefined. Pasa el elemento en sí, no una cadena de selector.
Volver a llamar al método para un elemento que no se está observando no cambia nada. En cambio, disconnect() elimina todos los objetivos. La observación se puede reanudar con observe(target).
El método no elimina el elemento del documento ni retira las entradas que ya se hayan pasado al callback. Resulta útil al limpiar un componente concreto.
Esta es una API del navegador especificada en Resize Observer Module Level 1, no una característica de ECMAScript. Tener Node 24 no demuestra que esté disponible en el navegador; comprueba el entorno de destino.
Ejemplos
(() => {
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);
})();Resultado
true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.