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

CKTIS / JavaScript

IntersectionObserver.disconnect(): detener la observación

disconnect() detiene la observación de todos los objetivos de un IntersectionObserver, pero permite reutilizar el observador.

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() elimina todos los objetivos de la observación de ese observador. No acepta argumentos y devuelve undefined. A diferencia de unobserve(target), no se limita a un solo elemento. Se puede llamar varias veces sin problema; una llamada posterior a observe(target) vuelve a iniciar la observación.

El método no vacía los registros que ya están en cola, por lo que una notificación ya encolada todavía puede invocar el callback. Para obtener y vaciar los registros pendientes, usa takeRecords(); procesa el resultado o descártalo de forma deliberada. Llama a disconnect() al limpiar un componente. Esta es una API web, no una función de una edición concreta de ECMAScript; comprueba si IntersectionObserver está disponible en el navegador de destino.

Ejemplos

(() => {
  const targets = [document.createElement('div'), document.createElement('div')];
  const observer = new IntersectionObserver(() => {});

  targets.forEach(target => observer.observe(target));
  console.log(observer.disconnect() === undefined);
  observer.disconnect();
  console.log(observer.takeRecords().length);

  observer.observe(targets[0]);
  observer.disconnect();
})();

Resultado

true
0

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