--- title: MutationObserver slug: Web/API/MutationObserver tags: - API - DOM - DOM Reference - Interface - MutationObserver - NeedsContent - NeedsUpdate - Reference - mutation - observers - resize translation_of: Web/API/MutationObserver ---
{{APIRef("DOM WHATWG")}}

{{domxref("MutationObserver")}} インターフェイスは、 DOM ツリーへ変更が加えられたことを監視することができる機能を提供します。これは DOM3 Events の仕様で定義されていた Mutation Events 機能の置き換えとして設計されたものです。

コンストラクター

{{domxref("MutationObserver.MutationObserver", "MutationObserver()")}}
DOM の変更が行われたときに指定されたコールバック関数を呼び出す新しい MutationObserver を生成して返します。

メソッド

{{domxref("MutationObserver.disconnect()", "disconnect()")}}
MutationObserver のインスタンスが今後の通知を受け取ることを、 {{domxref("MutationObserver.observe", "observe()")}} が再び呼び出されるまで停止します。
{{domxref("MutationObserver.observe()", "observe()")}}
指定したオプションに合う DOM の変更が発生したときに、コールバック関数を介して通知を受信し始めるように MutationObserver を構成します。
{{domxref("MutationObserver.takeRecords()", "takeRecords()")}}
MutationObserver の通知キューから保留中の通知をすべて削除し、 {{domxref("MutationRecord")}} の新しい配列 ({{jsxref("Array")}}) で返します。

Mutation Observer と resize イベントリスナーのカスタマイズとデモ

https://codepen.io/webgeeker/full/YjrZgg/

例

以下の例は このブログ記事 を参考にしたものです。

// 変更を監視するノードを選択
const targetNode = document.getElementById('some-id');

// (変更を監視する) オブザーバーのオプション
const config = { attributes: true, childList: true, subtree: true };

// 変更が発見されたときに実行されるコールバック関数
const callback = function(mutationsList, observer) {
    // Use traditional 'for loops' for IE 11
    for(const mutation of mutationsList) {
        if (mutation.type === 'childList') {
            console.log('A child node has been added or removed.');
        }
        else if (mutation.type === 'attributes') {
            console.log('The ' + mutation.attributeName + ' attribute was modified.');
        }
    }
};

// コールバック関数に結びつけられたオブザーバーのインスタンスを生成
const observer = new MutationObserver(callback);

// 対象ノードの設定された変更の監視を開始
observer.observe(targetNode, config);

// その後で、監視を停止することができる
observer.disconnect();

仕様書

仕様書 状態 備考
{{SpecName('DOM WHATWG', '#interface-mutationobserver', 'MutationObserver')}} {{ Spec2('DOM WHATWG') }}

ブラウザーの互換性

{{Compat("api.MutationObserver")}}

関連情報