CKTIS / JavaScript
MutationRecord: kako prebrati zapis o spremembi v DOM-u
Ugotovi vrsto spremembe in vozlišče, na katero vpliva, preveri dodane ali odstranjene otroke in ugotovi, kdaj zapis vsebuje prejšnjo vrednost.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord opisuje posamezno spremembo v DOM-u. MutationObserver posreduje zapise povratni funkciji v mikroopravilu, ne med samo spremembo. Te lastnosti so samo za branje. Začni z type, da pravilno razumeš druga polja. To je API spletne platforme, ne del ECMAScripta 2024; ne predpostavljaj, da je na voljo v okolju brez DOM-a.
Pri type === "childList" je target vozlišče, katerega neposredni otroci so se spremenili. addedNodes in removedNodes sta objekta NodeList, ki vsebujeta otroke, dodane oziroma odstranjene s to spremembo. Če ni bilo nič dodano ali odstranjeno, je ustrezni seznam prazen in ni null. Premik vozlišča lahko ustvari ločena zapisa za odstranitev in dodajanje.
Pri type === "attributes" je target spremenjeni element. attributeName vsebuje lokalno ime atributa brez predpone imenskega prostora. oldValue vsebuje prejšnjo vrednost atributa kot niz, če je bilo pri klicu observe() nastavljeno attributeOldValue: true. Sicer je vrednost null, tako kot takrat, ko atribut prej ni obstajal.
Pri type === "characterData" je target samo vozlišče CharacterData, na primer besedilno vozlišče, ne njegov starš. oldValue vsebuje prejšnje podatke kot niz le z characterDataOldValue: true; sicer je vrednost null. Pri "childList" je oldValue vedno null. Kadar tip ni "attributes", je attributeName enak null; kadar ni "childList", sta oba seznama vozlišč prazna.
Z subtree: true je lahko target zapisa potomec vozlišča, podanega metodi observe(). Polje newValue ne obstaja: z branjem iz target dobiš trenutno stanje, ki lahko že odraža poznejše spremembe.
Primeri
<!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>Rezultat
["attributes","DIV",[],[],"data-state","before"] ["characterData","#text",[],[],null,"hello"] ["childList","DIV",["SPAN"],[],null,null] ["childList","DIV",[],["SPAN"],null,null]
Shrani celoten primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. `takeRecords()` prevzame zapise in izprazni čakalno vrsto pred klicem povratne funkcije, zato se izpišejo štirje zapisi po vrsti. Zapis o dodajanju še vedno vsebuje `SPAN`, čeprav je bilo vozlišče pozneje odstranjeno.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednja · Različica: 3
Viri
- 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()