Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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