CKTIS / JavaScript
MutationRecord: jak číst záznam o změně v DOM
Zjistěte typ změny a dotčený uzel, prohlédněte si přidané nebo odebrané potomky a ověřte, kdy záznam obsahuje předchozí hodnotu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord popisuje jednu změnu v DOM. MutationObserver předává záznamy zpětnému volání v mikroúloze, nikoli během samotné změny. Tyto vlastnosti jsou jen pro čtení. Nejprve přečtěte type, podle něj vyložte ostatní pole. Jde o API webové platformy, nikoli o součást ECMAScriptu 2024; v prostředí bez DOM nepředpokládejte jeho dostupnost.
Při type === "childList" označuje target uzel, jehož přímí potomci se změnili. addedNodes a removedNodes jsou objekty NodeList s potomky, které daná změna přidala, respektive odebrala. Pokud nebyl žádný potomek přidán nebo odebrán, příslušný seznam je prázdný, nikoli null. Přesun uzlu může vytvořit samostatné záznamy o odebrání a přidání.
Při type === "attributes" je target změněný element. attributeName obsahuje lokální název atributu bez prefixu jmenného prostoru. oldValue obsahuje předchozí hodnotu atributu jako řetězec, pokud bylo při volání observe() nastaveno attributeOldValue: true. Jinak má hodnotu null, stejně jako když atribut předtím neexistoval.
Při type === "characterData" je target samotný uzel CharacterData, například textový uzel, nikoli jeho rodič. oldValue obsahuje předchozí data jako řetězec jen s characterDataOldValue: true; jinak má hodnotu null. Pro "childList" je oldValue vždy null. Mimo případ "attributes" je attributeName rovno null a mimo případ "childList" jsou oba seznamy uzlů prázdné.
Při subtree: true může být target záznamu potomkem uzlu předaného metodě observe(). Pole newValue neexistuje: čtením z target získáte aktuální stav, který už může odrážet pozdější změny.
Pří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ýsledek
["attributes","DIV",[],[],"data-state","before"] ["characterData","#text",[],[],null,"hello"] ["childList","DIV",["SPAN"],[],null,null] ["childList","DIV",[],["SPAN"],null,null]
Uložte celý příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup v konzoli. `takeRecords()` vybere záznamy a vyprázdní frontu před zpětným voláním, takže kód vypíše čtyři záznamy v pořadí. Záznam o přidání stále obsahuje `SPAN`, i když byl uzel později odebrán.
Související lekce
- JavaScript · Lekce 31 · Středně pokročilá · Verze: 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()