MutationEvent extension type

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:

  • Their design is flawed.
  • Adding DOM mutation listeners to a document profoundly degrades the performance of further DOM modifications to that document (making them 1.5 - 7 times slower!). Moreover, removing the listeners does not reverse the damage.
  • They have poor cross-browser compatibility: Safari doesn't support 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.

on
Implemented types

Properties

attrChange int
no setter
attrName String
no setter
bubbles bool
no setterinherited
cancelable bool
no setterinherited
cancelBubble bool
getter/setter pairinherited
composed bool
no setterinherited
currentTarget EventTarget?
no setterinherited
defaultPrevented bool
no setterinherited
eventPhase int
no setterinherited
hashCode int
The hash code for this object.
no setterinherited
isTrusted bool
no setterinherited
newValue String
no setter
prevValue String
no setter
relatedNode Node?
no setter
returnValue bool
getter/setter pairinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
srcElement EventTarget?
no setterinherited
target EventTarget?
no setterinherited
timeStamp DOMHighResTimeStamp
no setterinherited
type String
no setterinherited

Methods

composedPath() JSArray<EventTarget>
The composedPath() method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
inherited
initEvent(String type, [bool bubbles, bool cancelable]) → void
The Event.initEvent() method is used to initialize the value of an event created using Document.createEvent.
inherited
initMutationEvent(String typeArg, [bool bubblesArg, bool cancelableArg, Node? relatedNodeArg, String prevValueArg, String newValueArg, String attrNameArg, int attrChangeArg]) → void
The initMutationEvent() method of the MutationEvent interface initializes the value of a mutation event once it's been created (normally using the Document.createEvent method).
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
preventDefault() → void
The preventDefault() method of the Event interface tells the that if the event does not get explicitly handled, its default action should not be taken as it normally would be.
inherited
stopImmediatePropagation() → void
The stopImmediatePropagation() method of the Event interface prevents other listeners of the same event from being called.
inherited
stopPropagation() → void
The stopPropagation() method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the Event.preventDefault method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see Event.stopImmediatePropagation.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Properties

ADDITION int
no setter
MODIFICATION int
no setter
REMOVAL int
no setter