MutationObserverInit

MutationObserverInit 字典描述了 MutationObserver 的配置。因此,它主要被用作 MutationObserver.observe() 方法的参数类型。

属性

当调用 observe() 方法时,childListattributes 或者 characterData 三个属性之中,至少有一个必须为 true,否则会抛出 TypeError 异常。

attributeFilter 可选
要监视的特定属性名称的数组。如果未包含此属性,则对所有属性的更改都会触发变动通知。无默认值。
attributeOldValue (en-US) 可选
当监视节点的属性改动时,将此属性设为 true 将记录任何有改动的属性的上一个值。有关观察属性更改和值记录的详细信息,详见Monitoring attribute values in MutationObserver。无默认值。
attributes (en-US) 可选
设为 true 以观察受监视元素的属性值变更。默认值为 false
characterData (en-US) 可选
设为 true 以监视指定目标节点或子节点树中节点所包含的字符数据的变化。无默认值。
characterDataOldValue (en-US) 可选
设为 true 以在文本在受监视节点上发生更改时记录节点文本的先前值。详情及例子,请查看 Monitoring text content changes in MutationObserver。无默认值。
childList 可选
设为 true 以监视目标节点(如果 subtreetrue,则包含子孙节点)添加或删除新的子节点。默认值为 false
subtree (en-US) 可选
设为 true 以将监视范围扩展至目标节点整个节点树中的所有节点。MutationObserverInit 的其他值也会作用于此子树下的所有节点,而不仅仅只作用于目标节点。默认值为 false

规范

规范 状态 批注
DOM
MutationObserverInit
Living Standard

浏览器兼容性

BCD tables only load in the browser