Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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