Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ResizeObserver.disconnect() — detener todas las observaciones

El método disconnect() deja de observar todos los elementos registrados en una instancia de ResizeObserver. No destruye el observador: observe() puede iniciar la observación de nuevo.

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.disconnect()

observer.disconnect() no acepta argumentos y devuelve undefined. Vacía la lista de elementos observados por esta instancia y detiene sus observaciones activas. A diferencia de unobserve(target), elimina todas las observaciones, no solo una.

Llámalo al limpiar un componente. Volver a llamarlo es seguro; después puedes usar observe(target). No interrumpe un callback que ya se esté ejecutando.

El ejemplo desconecta el observador después de la primera notificación y, a continuación, cambia el ancho. Se espera un solo mensaje: entries: 1. Esta API del navegador está especificada en Resize Observer Module Level 1, no en ECMAScript; un entorno Node 24 no demuestra su disponibilidad en el navegador.

Ejemplos

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'width:100px;height:20px;';
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    console.log('entries:', entries.length);
    observer.disconnect();
    box.style.width = '200px';
    requestAnimationFrame(() => box.remove());
  });

  observer.observe(box);
})();

Resultado

entries: 1

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.

Fuentes