Module java.xml
Package org.w3c.dom.events

## Interface MutationEvent

- All Superinterfaces:
    `Event`

      public interface MutationEvent
      extends Event

  The `MutationEvent` interface provides specific contextual information associated with Mutation events.

  See also the Document Object Model (DOM) Level 2 Events Specification.

  Since:
    1.5, DOM Level 2

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `static short` | `ADDITION` | The `Attr` was just added.
    `static short` | `MODIFICATION` | The `Attr` was modified in place.
    `static short` | `REMOVAL` | The `Attr` was just removed.

    - ### Fields declared in interface org.w3c.dom.events.Event

      `AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE`

  - ### Method Summary

    Modifier and Type | Method | Description
    --- | --- | ---
    `short` | `getAttrChange()` | `attrChange` indicates the type of change which triggered the DOMAttrModified event.
    `String` | `getAttrName()` | `attrName` indicates the name of the changed `Attr` node in a DOMAttrModified event.
    `String` | `getNewValue()` | `newValue` indicates the new value of the `Attr` node in DOMAttrModified events, and of the `CharacterData` node in DOMCharacterDataModified events.
    `String` | `getPrevValue()` | `prevValue` indicates the previous value of the `Attr` node in DOMAttrModified events, and of the `CharacterData` node in DOMCharacterDataModified events.
    `Node` | `getRelatedNode()` | `relatedNode` is used to identify a secondary node related to a mutation event.
    `void` | `initMutationEvent​(String typeArg, boolean canBubbleArg, boolean cancelableArg, Node relatedNodeArg, String prevValueArg, String newValueArg, String attrNameArg, short attrChangeArg)` | The `initMutationEvent` method is used to initialize the value of a `MutationEvent` created through the `DocumentEvent` interface.

    - ### Methods declared in interface org.w3c.dom.events.Event

      `getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation`

- - ### Field Detail

    - #### MODIFICATION

          static final short MODIFICATION

      The `Attr` was modified in place.
      See Also:
        Constant Field Values

    - #### ADDITION

          static final short ADDITION

      The `Attr` was just added.
      See Also:
        Constant Field Values

    - #### REMOVAL

          static final short REMOVAL

      The `Attr` was just removed.
      See Also:
        Constant Field Values

  - ### Method Detail

    - #### getRelatedNode

          Node getRelatedNode()

      `relatedNode` is used to identify a secondary node related to a mutation event. For example, if a mutation event is dispatched to a node indicating that its parent has changed, the `relatedNode` is the changed parent. If an event is instead dispatched to a subtree indicating a node was changed within it, the `relatedNode` is the changed node. In the case of the DOMAttrModified event it indicates the `Attr` node which was modified, added, or removed.

    - #### getPrevValue

          String getPrevValue()

      `prevValue` indicates the previous value of the `Attr` node in DOMAttrModified events, and of the `CharacterData` node in DOMCharacterDataModified events.

    - #### getNewValue

          String getNewValue()

      `newValue` indicates the new value of the `Attr` node in DOMAttrModified events, and of the `CharacterData` node in DOMCharacterDataModified events.

    - #### getAttrName

          String getAttrName()

      `attrName` indicates the name of the changed `Attr` node in a DOMAttrModified event.

    - #### getAttrChange

          short getAttrChange()

      `attrChange` indicates the type of change which triggered the DOMAttrModified event. The values can be `MODIFICATION` , `ADDITION`, or `REMOVAL`.

    - #### initMutationEvent

          void initMutationEvent​(String typeArg,
                                 boolean canBubbleArg,
                                 boolean cancelableArg,
                                 Node relatedNodeArg,
                                 String prevValueArg,
                                 String newValueArg,
                                 String attrNameArg,
                                 short attrChangeArg)

      The `initMutationEvent` method is used to initialize the value of a `MutationEvent` created through the `DocumentEvent` interface. This method may only be called before the `MutationEvent` has been dispatched via the `dispatchEvent` method, though it may be called multiple times during that phase if necessary. If called multiple times, the final invocation takes precedence.
      Parameters:
        `typeArg` - Specifies the event type.
        `canBubbleArg` - Specifies whether or not the event can bubble.
        `cancelableArg` - Specifies whether or not the event's default action can be prevented.
        `relatedNodeArg` - Specifies the `Event`'s related Node.
        `prevValueArg` - Specifies the `Event`'s `prevValue` attribute. This value may be null.
        `newValueArg` - Specifies the `Event`'s `newValue` attribute. This value may be null.
        `attrNameArg` - Specifies the `Event`'s `attrName` attribute. This value may be null.
        `attrChangeArg` - Specifies the `Event`'s `attrChange` attribute