Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
The MutationEvent
interface provides event properties that are specific to modifications to the Document Object Model (DOM) hierarchy and nodes.
Note: Using mutation events is problematic:
DOMAttrModified
(see WebKit bug 8191) and Firefox doesn't support mutation name events (like DOMElementNameChanged
and DOMAttributeNameChanged
).They have been deprecated in favor of mutation observers. Consider using these instead.
Instance propertiesThis interface also inherits properties from its parent UIEvent
, and indirectly from Event
.
MutationEvent.attrChange
Read only Deprecated Non-standard
Indicates what kind of change triggered the DOMAttrModified
event. It can be MODIFICATION
(1
), ADDITION
(2
) or REMOVAL
(3
). It has no meaning for other events and is then set to 0
.
MutationEvent.attrName
Read only Deprecated Non-standard
Indicates the name of the node affected by the DOMAttrModified
event. It has no meaning for other events and is then set to the empty string (""
).
MutationEvent.newValue
Read only Deprecated Non-standard
In DOMAttrModified
events, contains the new value of the modified Attr
node. In DOMCharacterDataModified
events, contains the new value of the modified CharacterData
node. In all other cases, returns the empty string (""
).
MutationEvent.prevValue
Read only Deprecated Non-standard
In DOMAttrModified
events, contains the previous value of the modified Attr
node. In DOMCharacterDataModified
events, contains previous new value of the modified CharacterData
node. In all other cases, returns the empty string (""
).
Indicates the node related to the event, like the changed node inside the subtree for DOMSubtreeModified
.
MutationEvent.initMutationEvent()
Deprecated Non-standard
Constructor method that returns a new MutationEvent
configured with the parameters given.
The following is a list of all mutation events:
DOMAttrModified
(Not supported by Safari)DOMAttributeNameChanged
(Not supported by Firefox)DOMCharacterDataModified
DOMElementNameChanged
(Not supported by Firefox)DOMNodeInserted
DOMNodeInsertedIntoDocument
DOMNodeRemoved
DOMNodeRemovedFromDocument
DOMSubtreeModified
You can register a listener for mutation events using EventTarget.addEventListener()
as follows:
element.addEventListener(
"DOMNodeInserted",
(event) => {
// â¦
},
false,
);
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4