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

CKTIS / JavaScript

MutationRecord — zapis o spremembi DOM

MutationRecord opisuje eno zaznano spremembo DOM. Naučite se določiti njeno vrsto in zadevno vozlišče, pregledati dodana in odstranjena vozlišča ter pridobiti ime atributa in njegovo prejšnjo vrednost.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

record.type; record.target; record.addedNodes; record.removedNodes; record.attributeName; record.oldValue

MutationRecord je vmesnik samo za branje, ki opisuje spremembo DOM, zaznano z MutationObserver. Zapisi so posredovani v polju, ki ga prejme povratna funkcija opazovalnika; čakajoče zapise lahko pridobite tudi z takeRecords(). To je API DOM in ne del samega ECMAScripta. MDN ga uvršča med široko dostopne v brskalnikih od julija 2015; uporaba Node 24 v projektu ne dokazuje podpore za ta brskalniški API.

MutationRecord.type ima vrednost "attributes", "characterData" ali "childList". MutationRecord.target označuje element, katerega atribut se je spremenil, spremenjeno vozlišče CharacterData ali vozlišče, katerega seznam otrok se je spremenil — ne dodanega ali odstranjenega otroka.

MutationRecord.addedNodes in MutationRecord.removedNodes sta objekta NodeList, ki vsebujeta vozlišča, dodana oziroma odstranjena s to spremembo. Če ustreznih vozlišč ni, je seznam prazen. MutationRecord.attributeName vsebuje ime spremenjenega atributa pri "attributes", pri drugih vrstah pa je null.

MutationRecord.oldValue vsebuje prejšnjo vrednost atributa samo, če je omogočen attributeOldValue, oziroma prejšnje podatke CharacterData samo, če je omogočen characterDataOldValue. Opazovati je treba tudi ustrezno vrsto spremembe. Sicer, tudi pri "childList", je vrednost null; tudi pri atributu, ki prej ni obstajal, je lahko prejšnja vrednost null.

Primer opazuje odklopljen element in sinhrono prebere zapise z takeRecords(), ki izprazni čakalno vrsto. Zato ni treba čakati na povratno funkcijo. Ko pridobi zapise, prekine povezavo z opazovalnikom.

Primeri

(() => {
  const root = document.createElement("div");
  root.setAttribute("data-state", "idle");
  const observer = new MutationObserver(() => {});
  observer.observe(root, {
    attributes: true,
    attributeOldValue: true,
    childList: true
  });

  root.setAttribute("data-state", "ready");
  const child = document.createElement("span");
  root.appendChild(child);
  root.removeChild(child);

  const records = observer.takeRecords();
  observer.disconnect();
  for (const record of records) {
    console.log(JSON.stringify([
      record.type,
      record.target === root,
      record.addedNodes.length,
      record.removedNodes.length,
      record.attributeName,
      record.oldValue
    ]));
  }
})();

Rezultat

["attributes",true,0,0,"data-state","idle"]
["childList",true,1,0,null,null]
["childList",true,0,1,null,null]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri