Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

MutationRecord — záznam o zmene DOM

MutationRecord opisuje jednu pozorovanú zmenu DOM. Zistite, ako určiť jej typ a dotknutý uzol, prezrieť pridané a odstránené uzly a získať názov atribútu a jeho predchádzajúcu hodnotu.

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

Syntax

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

MutationRecord je rozhranie iba na čítanie, ktoré opisuje zmenu DOM pozorovanú pomocou MutationObserver. Záznamy sa odovzdávajú v poli funkcii spätného volania observera; čakajúce záznamy možno získať aj pomocou takeRecords(). Ide o API DOM, nie o súčasť samotného ECMAScriptu. MDN ho klasifikuje ako široko dostupné v prehliadačoch od júla 2015; prítomnosť Node 24 v projekte nedokazuje podporu tohto API prehliadača.

MutationRecord.type má hodnotu "attributes", "characterData" alebo "childList". MutationRecord.target označuje podľa typu element, ktorého atribút sa zmenil, zmenený uzol CharacterData alebo uzol, ktorého zoznam potomkov sa zmenil — nie pridaného či odstráneného potomka.

MutationRecord.addedNodes a MutationRecord.removedNodes sú objekty NodeList obsahujúce uzly pridané a odstránené danou zmenou. Ak nie sú k dispozícii zodpovedajúce uzly, príslušný zoznam je prázdny. MutationRecord.attributeName obsahuje názov zmeneného atribútu pre "attributes" a pri ostatných typoch má hodnotu null.

MutationRecord.oldValue obsahuje predchádzajúcu hodnotu atribútu iba vtedy, keď je zapnuté attributeOldValue, alebo predchádzajúce údaje CharacterData iba vtedy, keď je zapnuté characterDataOldValue. Zároveň treba sledovať zodpovedajúci druh zmeny. V ostatných prípadoch vrátane "childList" má hodnotu null; aj pri atribúte, ktorý predtým neexistoval, môže byť stará hodnota null.

Príklad sleduje odpojený element a synchronne číta záznamy pomocou takeRecords(), ktorá vyprázdni front. Netreba tak čakať na funkciu spätného volania. Po získaní záznamov observer odpojí.

Príklady

(() => {
  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
    ]));
  }
})();

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje