CKTIS / JavaScript
MutationRecord: jak odczytać zmianę w DOM
Ustal rodzaj zmiany i zmieniony węzeł, odczytaj dodane lub usunięte dzieci i sprawdź, kiedy rekord zawiera poprzednią wartość.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const { type, target, addedNodes, removedNodes, attributeName, oldValue } = record;MutationRecord opisuje pojedynczą zmianę w DOM. MutationObserver przekazuje rekordy do funkcji zwrotnej w ramach mikrozadania, a nie w trakcie samej zmiany. Te właściwości są tylko do odczytu. Zacznij od type: jego wartość określa znaczenie pozostałych pól. To API platformy webowej, a nie część ECMAScript 2024; nie zakładaj, że jest dostępne w środowisku bez DOM.
Przy type === "childList" właściwość target wskazuje węzeł, którego bezpośrednie dzieci się zmieniły. addedNodes i removedNodes to listy NodeList zawierające odpowiednio dzieci dodane i usunięte w tej zmianie. Gdy nic nie dodano lub nie usunięto, odpowiednia lista jest pusta, nie null. Przeniesienie węzła może dać osobne rekordy usunięcia i dodania.
Przy type === "attributes" właściwość target wskazuje zmieniony element. attributeName zawiera lokalną nazwę atrybutu, bez prefiksu przestrzeni nazw. oldValue zawiera poprzednią wartość atrybutu jako ciąg znaków, jeśli w observe() ustawiono attributeOldValue: true. W przeciwnym razie wynosi null, tak samo jak wtedy, gdy atrybut wcześniej nie istniał.
Przy type === "characterData" właściwość target wskazuje sam węzeł CharacterData, np. węzeł tekstowy, a nie jego rodzica. oldValue zawiera poprzednie dane jako ciąg znaków tylko przy characterDataOldValue: true; bez tej opcji wynosi null. Dla "childList" wartość oldValue zawsze wynosi null. Poza "attributes" właściwość attributeName wynosi null, a poza "childList" obie listy są puste.
Przy subtree: true pole target może wskazywać potomka węzła przekazanego do observe(). Rekord nie ma pola newValue: odczyt z target daje bieżący stan, w którym mogą już być widoczne późniejsze zmiany.
Przykłady
<!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>Wynik
["attributes","DIV",[],[],"data-state","before"] ["characterData","#text",[],[],null,"hello"] ["childList","DIV",["SPAN"],[],null,null] ["childList","DIV",[],["SPAN"],null,null]
Zapisz cały przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. `takeRecords()` pobiera i opróżnia kolejkę przed wywołaniem funkcji zwrotnej, więc kod wypisuje cztery rekordy po kolei. Dodanie `SPAN` pozostaje widoczne w swoim rekordzie mimo późniejszego usunięcia.
Powiązane lekcje
- JavaScript · Lekcja 31 · Średniozaawansowany · Wersja: 3
Źródła
- 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()