MutationRecord
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
TheMutationRecord
is a read-only interface that represents an individual DOM mutation observed by aMutationObserver
. It is the object inside the array passed to the callback of aMutationObserver
.
Instance properties
MutationRecord.addedNodes
Read onlyThe nodes added by a mutation. Will be an empty
NodeList
if no nodes were added.MutationRecord.attributeName
Read onlyThe name of the changed attribute as a string, or
null
.MutationRecord.attributeNamespace
Read onlyThe namespace of the changed attribute as a string, or
null
.MutationRecord.nextSibling
Read onlyThe next sibling of the added or removed nodes, or
null
.MutationRecord.oldValue
Read onlyThe 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.previousSibling
Read onlyThe previous sibling of the added or removed nodes, or
null
.MutationRecord.removedNodes
Read onlyThe nodes removed by a mutation. Will be an empty
NodeList
if no nodes were removed.MutationRecord.target
Read onlyThe node the mutation affected, depending on the
MutationRecord.type
.- For
attributes
, it is the element whose attribute changed. - For
characterData
, it is theCharacterData
node. - For
childList
, it is the node whose children changed.
- For
MutationRecord.type
Read onlyA string representing the type of mutation:
attributes
if the mutation was an attribute mutation,characterData
if it was a mutation to aCharacterData
node, andchildList
if it was a mutation to the tree of nodes.
Specifications
Specification |
---|
DOM # interface-mutationrecord |