coderef

Mutation eventsLimited availability

Mutation events like DOMSubtreeModified, DOMNodeInserted, or DOMNodeRemoved fire when DOM changes occur.

Not yet supported in all major browsers — check the table and provide a fallback.

Discouraged: Mutation events negatively impact performance and they were selected for removal from the web as part of Interop 2025. Use instead: MutationObserver

How to use ↓Compare browsers

Browser support

DesktopChrome
✕Not supportedup to 155
Current: 155
Edge
✕Not supportedup to 154
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
✕Not supportedup to 155
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Chrome, Edge, Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: MutationEvent.

Feature detection

JS · check before using
if ("MutationEvent" in globalThis) {
  // MutationEvent is available
} else {
  // load a polyfill or use a fallback
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (7). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
MutationEvent✕✕✕✕✕✕✕
MutationEvent.attrChange✕✕✕✕✕✕✕
MutationEvent.attrName✕✕✕✕✕✕✕
MutationEvent.initMutationEvent✕✕✕✕✕✕✕
MutationEvent.newValue✕✕✕✕✕✕✕
MutationEvent.prevValue✕✕✕✕✕✕✕
MutationEvent.relatedNode✕✕✕✕✕✕✕