CKTIS / JavaScript
MutationRecord: kako pročitati zapis o promjeni u DOM-u
Utvrdi vrstu promjene i zahvaćeni čvor, pregledaj dodanu ili uklonjenu djecu i provjeri kada zapis sadrži prethodnu vrijednost.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord opisuje jednu promjenu u DOM-u. MutationObserver predaje zapise povratnoj funkciji u mikrozadatku, a ne tijekom same promjene. Ta su svojstva samo za čitanje. Počni od type kako bi protumačio ostala polja. To je API web-platforme, a ne dio ECMAScripta 2024; ne pretpostavljaj da je dostupan u okruženju bez DOM-a.
Ako je type === "childList", target je čvor čija su se izravna djeca promijenila. addedNodes i removedNodes objekti su tipa NodeList koji sadrže djecu dodanu odnosno uklonjenu tom promjenom. Ako ništa nije dodano ili uklonjeno, odgovarajući je popis prazan, a ne null. Premještanje čvora može proizvesti zasebne zapise o uklanjanju i dodavanju.
Ako je type === "attributes", target je promijenjeni element. attributeName sadrži lokalni naziv atributa, bez prefiksa imenskog prostora. oldValue sadrži prethodnu vrijednost atributa kao znakovni niz ako je pri pozivu observe() postavljeno attributeOldValue: true. Inače je vrijednost null, kao i kada atribut prije nije postojao.
Ako je type === "characterData", target je sam čvor CharacterData, primjerice tekstni čvor, a ne njegov roditelj. oldValue sadrži prethodne podatke kao znakovni niz samo uz characterDataOldValue: true; inače je vrijednost null. Za "childList" vrijednost oldValue uvijek je null. Kad vrsta nije "attributes", attributeName ima vrijednost null, a kad nije "childList", oba su popisa čvorova prazna.
Uz subtree: true svojstvo target u zapisu može upućivati na potomka čvora predanog metodi observe(). Polje newValue ne postoji: čitanjem iz target dobivaš trenutačno stanje, koje već može odražavati kasnije promjene.
Primjeri
<!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]
Spremi cijeli primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli. `takeRecords()` preuzima zapise i prazni red čekanja prije poziva povratne funkcije, pa se redom ispisuju četiri zapisa. Zapis o dodavanju i dalje sadrži `SPAN`, iako je čvor poslije uklonjen.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednje · Verzija: 3
Izvori
- 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()