--- title: MutationRecord slug: Web/API/MutationRecord tags: - API - Advanced - DOM - DOM Reference - NeedsContent - Reference translation_of: Web/API/MutationRecord ---

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

{{英語版章題("Properties")}}

プロパティ

プロパティ 意味
{{domxref("MutationRecord.type")}} String 属性値の変更の場合は "attributes"CharacterData ノードに対する変更の場合は "characterData"、ノードのツリーに対する変更の場合は "childList" を返します。
{{domxref("MutationRecord.target")}} {{domxref("Node")}}

変更の影響を受けたノードを返します。戻り値は {{domxref("MutationRecord.type")}} に応じて以下のように変わります。

attributes の場合、属性が変更された要素となります。

characterData の場合、CharacterData ノードとなります。

childList の場合、子ノードが変更されたノードとなります。

{{domxref("MutationRecord.addedNodes")}} {{domxref("NodeList")}}

追加されたノードを返します。何もノードが追加されていなかった場合は、空の {{domxref("NodeList")}} が返されます。

{{domxref("MutationRecord.removedNodes")}} {{domxref("NodeList")}} 削除されたノードを返します。何もノードが削除されていなかった場合は、空の {{domxref("NodeList")}} が返されます。
{{domxref("MutationRecord.previousSibling")}} {{domxref("Node")}}

追加あるいは削除されたノードの直前にあるノード、もしくは null を返します。

{{domxref("MutationRecord.nextSibling")}} {{domxref("Node")}} 追加あるいは削除されたノードの直後にあるノード、もしくは null を返します。
{{domxref("MutationRecord.attributeName")}} String 変更された属性のローカル名、もしくは null を返します。
{{domxref("MutationRecord.attributeNamespace")}} String 変更された属性の名前空間、もしくは null を返します。
{{domxref("MutationRecord.oldValue")}} String

戻り値は {{domxref("MutationRecord.type")}} に応じて以下のように変わります。

attributes の場合、変更された属性の変更前の属性値となります。

characterData の場合、変更されたノードの変更前のデータとなります。

childList の場合、null となります。

{{英語版章題("Specifications")}}

仕様

仕様書 策定状況 備考
{{SpecName('DOM WHATWG', '#mutationrecord', 'MutationRecord')}} {{ Spec2('DOM WHATWG') }}  
{{SpecName('DOM4', '#mutationrecord', 'MutationRecord')}} {{ Spec2('DOM4') }}