MutationRecord

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

MutationRecord 是一个只读接口,表示由 MutationObserver 观察到的单个 DOM 变异。它是传递给 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

浏览器兼容性