CKTIS / JavaScript
MutationRecord: ako čítať záznam o zmene v DOM
Zistite typ zmeny a dotknutý uzol, prezrite si pridané alebo odstránené deti a overte, kedy záznam obsahuje predchádzajúcu hodnotu.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord opisuje jednu zmenu v DOM. MutationObserver odovzdáva záznamy funkcii spätného volania v mikroúlohe, nie počas samotnej zmeny. Tieto vlastnosti sú len na čítanie. Začnite vlastnosťou type, ktorá určuje význam ostatných polí. Ide o API webovej platformy, nie o súčasť ECMAScriptu 2024; v prostredí bez DOM nepredpokladajte jeho dostupnosť.
Pri type === "childList" je target uzol, ktorého priame deti sa zmenili. addedNodes a removedNodes sú objekty NodeList s deťmi pridanými, respektíve odstránenými pri tejto zmene. Ak sa žiadne dieťa nepridalo alebo neodstránilo, príslušný zoznam je prázdny, nie null. Presun uzla môže vytvoriť samostatné záznamy o odstránení a pridaní.
Pri type === "attributes" je target zmenený prvok. attributeName obsahuje lokálny názov atribútu bez predpony menného priestoru. oldValue obsahuje predchádzajúcu hodnotu atribútu ako reťazec, ak bolo pri volaní observe() nastavené attributeOldValue: true. Inak má hodnotu null, rovnako ako vtedy, keď atribút predtým neexistoval.
Pri type === "characterData" je target samotný uzol CharacterData, napríklad textový uzol, nie jeho rodič. oldValue obsahuje predchádzajúce údaje ako reťazec len s characterDataOldValue: true; inak má hodnotu null. Pre "childList" má oldValue vždy hodnotu null. Mimo prípadu "attributes" má attributeName hodnotu null a mimo prípadu "childList" sú oba zoznamy uzlov prázdne.
Pri subtree: true môže byť target záznamu potomkom uzla odovzdaného metóde observe(). Pole newValue neexistuje: čítaním z target získate aktuálny stav, ktorý už môže odrážať neskoršie zmeny.
Príklady
<!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>Výsledok
["attributes","DIV",[],[],"data-state","before"] ["characterData","#text",[],[],null,"hello"] ["childList","DIV",["SPAN"],[],null,null] ["childList","DIV",[],["SPAN"],null,null]
Uložte celý príklad ako súbor HTML, otvorte ho v prehliadači a skontrolujte výstup v konzole. `takeRecords()` vyberie záznamy a vyprázdni front pred spätným volaním, takže kód vypíše štyri záznamy v poradí. Záznam o pridaní stále obsahuje `SPAN`, aj keď bol uzol neskôr odstránený.
Súvisiace lekcie
- JavaScript · Lekcia 31 · Stredne pokročilá · Verzia: 3
Zdroje
- 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()