MutationRecord

MutationRecord は、 DOM に生じた個々の変更を表します。これは MutationObserver のコールバック関数に渡されるオブジェクトです。

プロパティ

プロパティ 型 意味
MutationRecord.type (en-US) String 属性値の変更の場合は "attributes"、CharacterData ノードに対する変更の場合は "characterData"、ノードのツリーに対する変更の場合は "childList" を返します。
MutationRecord.target (en-US) Node 変更の影響を受けたノードを、 MutationRecord.type (en-US) に応じて返します。
attributes の場合、属性が変更された要素となります。
characterData の場合、CharacterData ノードとなります。
childList の場合、子ノードが変更されたノードとなります。
MutationRecord.addedNodes (en-US) NodeList 追加されたノードを返します。何もノードが追加されていなかった場合は、空の NodeList を返します。
MutationRecord.removedNodes (en-US) NodeList 削除されたノードを返します。何もノードが削除されていなかった場合は、空の NodeList を返します。
MutationRecord.previousSibling (en-US) Node 追加あるいは削除されたノードの直前にあるノード、もしくは null を返します。
MutationRecord.nextSibling (en-US) Node 追加あるいは削除されたノードの直後にあるノード、もしくは null を返します。
MutationRecord.attributeName (en-US) String 変更された属性のローカル名、もしくは null を返します。
MutationRecord.attributeNamespace (en-US) String 変更された属性の名前空間、もしくは null を返します。
MutationRecord.oldValue (en-US) String

返値は MutationRecord.type (en-US) に応じて以下のように変わります。
attributes の場合、変更された属性の変更前の属性値となります。
characterData の場合、変更されたノードの変更前のデータとなります。
childList の場合、null となります。

なお、この機能が正常に動作するためには、 MutationObserver observe メソッドの対応する MutationObserverInit (en-US) 引数で、 attributeOldValue または characterDataOldValue が true に設定されている必要があります

仕様書

Specification
DOM Standard
# interface-mutationrecord

ブラウザーの互換性

BCD tables only load in the browser