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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 18Edge Full support YesFirefox Full support 14IE Full support 11Opera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 14Opera Android Full support 14Safari iOS Full support 6Samsung Internet Android Full support Yes

Legend

Full support  
Full support

Document Tags and Contributors

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