このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

MutationRecord

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

MutationRecord は読み取り専用のインターフェイスで、DOM に生じた個々の変更のうち、MutationObserver で監視されているものを表します。これは MutationObserver のコールバック関数に渡されるオブジェクトです。

インスタンスプロパティ

MutationRecord.addedNodes 読取専用

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

MutationRecord.attributeName 読取専用

変更された属性のローカル名、もしくは null を返します。

MutationRecord.attributeNamespace 読取専用

変更された属性の名前空間、もしくは null を返します。

MutationRecord.nextSibling 読取専用

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

MutationRecord.oldValue 読取専用

MutationRecord.type によって変わる値です。

  • attributes の場合、これは変更が行われる前の、変更された属性の値です。
  • characterData の場合、変更前のノードのデータです。
  • childList の場合、null です。
MutationRecord.previousSibling 読取専用

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

MutationRecord.removedNodes 読取専用

削除されたノードを返します。何もノードが削除されていなかった場合は、空の NodeList を返します。

MutationRecord.target 読取専用

変更の影響を受けたノードを、 MutationRecord.type に応じて返します。

  • attributes の場合、属性が変更された要素となります。
  • characterData の場合、CharacterData ノードとなります。
  • childList の場合、子ノードが変更されたノードとなります。
MutationRecord.type 読取専用

変更の種類の文字列です。属性の変更の場合は attributes、CharacterData ノードへの変更の場合は characterData、ノードのツリーへの変更の場合は childList です。

仕様書

仕様書
DOM
# interface-mutationrecord

ブラウザーの互換性