MutationObserver:disconnect() 方法

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①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。