MutationObserver.disconnect()

The MutationObserver method disconnect() tells the observer to stop watching for mutations.

The observer can be reused by calling its observe() method again.

Syntax

mutationObserver.disconnect()

Parameters

None.

Return value

undefined.

Usage notes

If the element being observed is removed from the DOM, and then subsequently released by the browser's garbage collection mechanism, the MutationObserver will stop observing the removed element. However, the MutationObserver itself can continue to exist to observe other existing elements.

Example

This example creates an observer, then disconnects from it, leaving it available for possible reuse.

const targetNode = document.querySelector("#someElement");
const observerOptions = {
  childList: true,
  attributes: true
}

const observer = new MutationObserver(callback);
observer.observe(targetNode, observerOptions);

/* some time later... */

observer.disconnect();

Specifications

Browser compatibility