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.

Note: All notifications of mutations that have already been detected but not yet reported to the observer are discarded.

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 is likewise deleted.

Example

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

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

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

/* some time later... */

observer.disconnect();

Specifications

Specification Status Comment
DOM
The definition of 'MutationObserver.disconnect()' in that specification.
Living Standard  

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support18 Yes1411156
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support1818 Yes14146 Yes

Document Tags and Contributors

Contributors to this page: fscholz, Sheppy
Last updated by: fscholz,