大网数据广告活动
Web 标准与前端开发

MutationEvent

· 52CE 我爱测

The **`MutationEvent`** interface provides event properties that are specific to modifications to the Document Object Model (DOM) hierarchy and nodes.

UI Events

The MutationEvent interface provides event properties that are specific to modifications to the Document Object Model (DOM) hierarchy and nodes.

[!NOTE] Using mutation events is problematic:

  • Their design is flawed.
  • Adding DOM mutation listeners to a document profoundly degrades the performance of further DOM modifications to that document (making them 1.5 - 7 times slower!). Moreover, removing the listeners does not reverse the damage.
  • They have poor cross-browser compatibility: Safari doesn't support DOMAttrModified (see WebKit bug 8191) and Firefox doesn't support mutation name events (like DOMElementNameChanged and DOMAttributeNameChanged).

They have been deprecated in favor of mutation observers. Consider using these instead.

Instance properties

This interface also inherits properties from its parent UIEvent, and indirectly from Event.

  • MutationEvent.attrChange
    • : Indicates what kind of change triggered the DOMAttrModified event. It can be MODIFICATION (1), ADDITION (2) or REMOVAL (3). It has no meaning for other events and is then set to 0.
  • MutationEvent.attrName
    • : Indicates the name of the node affected by the DOMAttrModified event. It has no meaning for other events and is then set to the empty string ("").
  • MutationEvent.newValue
    • : In DOMAttrModified events, contains the new value of the modified Attr node. In DOMCharacterDataModified events, contains the new value of the modified CharacterData node. In all other cases, returns the empty string ("").
  • MutationEvent.prevValue
    • : In DOMAttrModified events, contains the previous value of the modified Attr node. In DOMCharacterDataModified events, contains previous new value of the modified CharacterData node. In all other cases, returns the empty string ("").
  • MutationEvent.relatedNode
    • : Indicates the node related to the event, like the changed node inside the subtree for DOMSubtreeModified.

Instance methods

  • MutationEvent.initMutationEvent()
    • : Constructor method that returns a new MutationEvent configured with the parameters given.

Mutation events list

The following is a list of all mutation events:

  • DOMAttrModified (Not supported by Safari)
  • DOMAttributeNameChanged (Not supported by Firefox)
  • DOMCharacterDataModified
  • DOMElementNameChanged (Not supported by Firefox)
  • DOMNodeInserted
  • DOMNodeInsertedIntoDocument
  • DOMNodeRemoved
  • DOMNodeRemovedFromDocument
  • DOMSubtreeModified

Examples

You can register a listener for mutation events using EventTarget.addEventListener() as follows:

element.addEventListener("DOMNodeInserted", (event) => {
  // …
});

Specifications

Browser compatibility

See also

  • MutationObserver

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。