MutationRecord
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The MutationRecord is a read-only interface that represents an individual DOM mutation observed by a MutationObserver. It is the object inside the array passed to the callback of a MutationObserver.
Instance properties
MutationRecord.addedNodesRead only-
The nodes added by a mutation. Will be an empty
NodeListif no nodes were added. MutationRecord.attributeNameRead only-
The name of the changed attribute as a string, or
null. MutationRecord.attributeNamespaceRead only-
The namespace of the changed attribute as a string, or
null. MutationRecord.nextSiblingRead only-
The next sibling of the added or removed nodes, or
null. MutationRecord.oldValueRead only-
The value depends on the
MutationRecord.type:- For
attributes, it is the value of the changed attribute before the change. - For
characterData, it is the data of the changed node before the change. - For
childList, it isnull.
- For
MutationRecord.previousSiblingRead only-
The previous sibling of the added or removed nodes, or
null. MutationRecord.removedNodesRead only-
The nodes removed by a mutation. Will be an empty
NodeListif no nodes were removed. MutationRecord.targetRead only-
The node the mutation affected, depending on the
MutationRecord.type.- For
attributes, it is the element whose attribute changed. - For
characterData, it is theCharacterDatanode. - For
childList, it is the node whose children changed.
- For
MutationRecord.typeRead only-
A string representing the type of mutation:
attributesif the mutation was an attribute mutation,characterDataif it was a mutation to aCharacterDatanode, andchildListif it was a mutation to the tree of nodes.
Specifications
| Specification |
|---|
| DOM # interface-mutationrecord |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
MutationRecord
|
|
|
|
|
|
|
|
|
|
|
|
|
addedNodes
|
|
|
|
|
|
|
|
|
|
|
|
|
attributeName
|
|
|
|
|
|
|
|
|
|
|
|
|
attributeNamespace
|
|
|
|
|
|
|
|
|
|
|
|
|
nextSibling
|
|
|
|
|
|
|
|
|
|
|
|
|
oldValue
|
|
|
|
|
|
|
|
|
|
|
|
|
previousSibling
|
|
|
|
|
|
|
|
|
|
|
|
|
removedNodes
|
|
|
|
|
|
|
|
|
|
|
|
|
target
|
|
|
|
|
|
|
|
|
|
|
|
|
type
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support