CKTIS / JavaScript
MutationRecord — запис за промяна в DOM
MutationRecord описва една наблюдавана промяна в DOM. Научете как да определите типа и засегнатия възел, да разгледате добавените и премахнатите възли и да получите името на атрибут и предишната му стойност.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
record.type; record.target; record.addedNodes; record.removedNodes; record.attributeName; record.oldValueMutationRecord е интерфейс само за четене, който описва промяна в DOM, наблюдавана чрез MutationObserver. Записите се подават в масива, предаден на функцията за обратно извикване на наблюдателя; чакащите записи могат да се получат и с takeRecords(). Това е API на DOM, а не част от самия ECMAScript. MDN го класифицира като широко достъпно в браузърите от юли 2015 г.; наличието на Node 24 в даден проект не доказва поддръжка на това API на браузъра.
MutationRecord.type е "attributes", "characterData" или "childList". MutationRecord.target обозначава съответно елемента, чийто атрибут е променен, променения възел CharacterData или възела, чийто списък с деца е променен — не добавеното или премахнатото дете.
MutationRecord.addedNodes и MutationRecord.removedNodes са обекти NodeList, съдържащи възлите, добавени и премахнати при тази промяна. Ако няма съответни възли, списъкът е празен. MutationRecord.attributeName съдържа името на променения атрибут при "attributes", а при останалите типове е null.
MutationRecord.oldValue съдържа предишната стойност на атрибута само когато е включено attributeOldValue, или предишните данни на CharacterData само когато е включено characterDataOldValue. Трябва да се наблюдава и съответният вид промяна. В останалите случаи, включително при "childList", стойността е null; при атрибут, който преди това не е съществувал, предишната стойност също може да е null.
Примерът наблюдава отделен от документа елемент и синхронно прочита записите чрез takeRecords(), което изпразва опашката. Така не се налага да се чака функцията за обратно извикване. След като получи записите, примерът прекъсва връзката с наблюдателя.
Примери
(() => {
const root = document.createElement("div");
root.setAttribute("data-state", "idle");
const observer = new MutationObserver(() => {});
observer.observe(root, {
attributes: true,
attributeOldValue: true,
childList: true
});
root.setAttribute("data-state", "ready");
const child = document.createElement("span");
root.appendChild(child);
root.removeChild(child);
const records = observer.takeRecords();
observer.disconnect();
for (const record of records) {
console.log(JSON.stringify([
record.type,
record.target === root,
record.addedNodes.length,
record.removedNodes.length,
record.attributeName,
record.oldValue
]));
}
})();Резултат
["attributes",true,0,0,"data-state","idle"] ["childList",true,1,0,null,null] ["childList",true,0,1,null,null]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.