CKTIS / JavaScript
MutationRecord: как да прочетеш запис за промяна в DOM
Определи вида на промяната и засегнатия възел, разгледай добавените или премахнатите дъщерни възли и провери кога записът съдържа предишната стойност.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord описва една промяна в DOM. MutationObserver предава записите на функцията за обратно извикване в микрозадача, а не по време на самата промяна. Тези свойства са само за четене. Започни с type, за да разтълкуваш останалите полета. Това е API на уеб платформата, а не част от ECMAScript 2024; не приемай, че е достъпен в среда без DOM.
При type === "childList" полето target сочи възела, чиито преки дъщерни възли са се променили. addedNodes и removedNodes са обекти NodeList, които съдържат съответно добавените и премахнатите при тази промяна дъщерни възли. Ако няма добавени или премахнати възли, съответният списък е празен, а не null. Преместването на възел може да създаде отделни записи за премахване и добавяне.
При type === "attributes" полето target сочи променения елемент. attributeName съдържа локалното име на атрибута, без префикса на именуваното пространство. oldValue съдържа предишната стойност на атрибута като низ, ако при извикването на observe() е зададено attributeOldValue: true. Иначе стойността е null, както и когато атрибутът не е съществувал преди промяната.
При type === "characterData" полето target сочи самия възел CharacterData, например текстов възел, а не неговия родител. oldValue съдържа предишните данни като низ само при characterDataOldValue: true; иначе е null. При "childList" стойността на oldValue винаги е null. Когато типът не е "attributes", attributeName е null, а когато не е "childList", и двата списъка с възли са празни.
При subtree: true полето target в записа може да сочи наследник на възела, подаден на observe(). Няма поле newValue: при четене от target получаваш текущото състояние, което вече може да отразява по-късни промени.
Примери
<!doctype html>
<meta charset="utf-8">
<title>MutationRecord example</title>
<script>
(() => {
const root = document.createElement("div");
const text = document.createTextNode("hello");
const child = document.createElement("span");
root.setAttribute("data-state", "before");
root.append(text);
const observer = new MutationObserver(() => {});
observer.observe(root, {
attributes: true,
attributeOldValue: true,
characterData: true,
characterDataOldValue: true,
childList: true,
subtree: true,
});
root.setAttribute("data-state", "after");
text.data = "world";
root.append(child);
child.remove();
const records = observer.takeRecords();
observer.disconnect();
const nodeNames = (nodes) => Array.from(nodes, (node) => node.nodeName);
for (const { type, target, addedNodes, removedNodes, attributeName, oldValue } of records) {
console.log(JSON.stringify([
type, target.nodeName, nodeNames(addedNodes), nodeNames(removedNodes),
attributeName, oldValue,
]));
}
})();
</script>Резултат
["attributes","DIV",[],[],"data-state","before"] ["characterData","#text",[],[],null,"hello"] ["childList","DIV",["SPAN"],[],null,null] ["childList","DIV",[],["SPAN"],null,null]
Запази целия пример като HTML файл, отвори го в браузър и провери изхода в конзолата. `takeRecords()` взема записите и изпразва опашката преди изпълнението на функцията за обратно извикване, затова кодът извежда четири записа подред. Записът за добавяне все още съдържа `SPAN`, въпреки че възелът е премахнат по-късно.
Свързани уроци
- JavaScript · Урок 31 · Средно · Версия: 3
Източници
- MutationRecord
- MutationRecord: target property
- MutationRecord: addedNodes property
- MutationRecord: removedNodes property
- MutationRecord: attributeName property
- MutationRecord: oldValue property
- MutationObserver: observe() method
- MutationObserver: takeRecords() method
- Using microtasks in JavaScript with queueMicrotask()