MutationObserver: disconnect() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

MutationObserver 方法 disconnect() 告訴觀察者停止監視突變。

透過再次呼叫其 observe() 方法,可以重用該觀察者。

語法

js
disconnect()

引數

無。

返回值

undefined.

注意: 所有已經被*檢測到*但*尚未報告*給觀察者的突變通知都將被丟棄。要保留並處理已檢測到但未報告的突變,請使用 takeRecords() 方法。

用法說明

如果被觀察的元素從 DOM 中移除,然後被瀏覽器的垃圾收集機制釋放,則 MutationObserver 將停止觀察該被移除的元素。然而,MutationObserver 本身可以繼續存在以觀察其他現有元素。

示例

此示例建立了一個觀察者,然後斷開連線,使其可用於可能的重用。

js
const targetNode = document.querySelector("#someElement");
const observerOptions = {
  childList: true,
  attributes: true,
};

const observer = new MutationObserver(callback);
observer.observe(targetNode, observerOptions);

/* some time later… */

observer.disconnect();

規範

規範
DOM
# ref-for-dom-mutationobserver-disconnect①

瀏覽器相容性