MutationEvent: initMutationEvent() method

The initMutationEvent() method of the MutationEvent interface initializes the value of a mutation event once it’s been created (normally using the createEvent() method).

This method must be called to set the event before it is dispatched, using dispatchEvent().

[!NOTE] In general, you won’t create these events yourself; they are created by the browser.

Syntax

initMutationEvent(type, canBubble, cancelable, relatedNode,
                  prevValue, newValue, attrName, attrChange)

Parameters

• type
  • : A string to set the event’s type to. Browsers set the following values for MutationEvent: DOMAttrModified, DOMAttributeNameChanged, DOMCharacterDataModified, DOMElementNameChanged, DOMNodeInserted, DOMNodeInsertedIntoDocument, DOMNodeRemoved, DOMNodeRemovedFromDocument, DOMSubtreeModified.
• canBubble
  • : A boolean indicating whether or not the event can bubble. Sets the value of bubbles.
• cancelable
  • : A boolean indicating whether or not the event’s default action can be prevented. Sets the value of cancelable.
• relatedNode
  • : A string representing the new value of the modified node, if any. Sets the value of relatedNode.
• prevValue
  • : A string representing the previous value of the modified node, if any. Sets the value of prevValue.
• newValue
  • : A string representing the new value of the modified node, if any. Sets the value of newValue.
• attrName
  • : A string representing the name of the Attr node changed, if any. Sets the value of attrName.
• attrChange
  • : An integer representing the reason attribute node changed. Sets the value of attrChange.

Return value

None (undefined).

Specifications

Browser compatibility