MutationEvent

インスタンスプロパティ

このインターフェイスには親である UIEvent と、間接的に Event から継承したプロパティがあります。

MutationEvent.attrChange 読取専用

どのような変更が DOMAttrModified イベントのトリガーとなったかを示します。これは MODIFICATION (1)、ADDITION (2)、REMOVAL (3)のいずれかです。他のイベントに対しては意味を持たず、 0 に設定されます。

MutationEvent.attrName 読取専用

DOMAttrModified イベントの影響を受けるノードの名前を示します。他のイベントでは意味を持たず、空文字列 ("") に設定されます。

MutationEvent.newValue 読取専用

DOMAttrModified イベントでは、変更された Attr ノードの新しい値が格納されます。 DOMCharacterDataModified イベントでは、変更された CharacterData ノードの新しい値を返します。それ以外の場合は、空文字列 ("") を返します。

MutationEvent.prevValue 読取専用

DOMAttrModified イベントでは、変更前の Attr ノードの値が格納されます。 DOMCharacterDataModified イベントでは、変更された CharacterData ノードの新しい値を返します。それ以外の場合は、空文字列 ("") を返します。

MutationEvent.relatedNode 読取専用

DOMSubtreeModified のサブツリー内の変更されたノードのように、イベントに関連するノードを示します。

インスタンスメソッド

MutationEvent.initMutationEvent()

コンストラクターメソッドで、与えられた引数で構成された新しい MutationEvent を返します。

変異イベント一覧

以下はすべての変異イベントの一覧です。

• DOMAttrModified （Safari では未対応）
• DOMAttributeNameChanged （Firefox では未対応）
• DOMCharacterDataModified
• DOMElementNameChanged （Firefox では未対応）
• DOMNodeInserted
• DOMNodeInsertedIntoDocument
• DOMNodeRemoved
• DOMNodeRemovedFromDocument
• DOMSubtreeModified

例

変異イベントのリスナーは、 EventTarget.addEventListener() を使って以下のように登録できます。

element.addEventListener(
  "DOMNodeInserted",
  (event) => {
    // …
  },
  false,
);

仕様書

ブラウザーの互換性

関連情報

• MutationObserver