Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

MutationRecord — záznam o změně DOM

MutationRecord popisuje jednu pozorovanou změnu DOM. Zjistěte, jak určit její typ a dotčený uzel, prohlédnout přidané a odebrané uzly a získat název atributu a jeho předchozí hodnotu.

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

Syntaxe

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

MutationRecord je rozhraní pouze pro čtení, které popisuje změnu DOM pozorovanou pomocí MutationObserver. Záznamy se předávají v poli funkci zpětného volání observeru; čekající záznamy lze získat také pomocí takeRecords(). Jde o API DOM, nikoli o součást samotného ECMAScriptu. MDN jej klasifikuje jako široce dostupné v prohlížečích od července 2015; přítomnost Node 24 v projektu nedokazuje podporu tohoto API prohlížeče.

MutationRecord.type má hodnotu "attributes", "characterData" nebo "childList". MutationRecord.target označuje podle typu element, jehož atribut se změnil, změněný uzel CharacterData nebo uzel, jehož seznam potomků se změnil — nikoli přidaného či odebraného potomka.

MutationRecord.addedNodes a MutationRecord.removedNodes jsou objekty NodeList obsahující uzly přidané a odebrané danou změnou. Pokud žádné odpovídající uzly nejsou, je příslušný seznam prázdný. MutationRecord.attributeName obsahuje název změněného atributu pro "attributes" a pro ostatní typy má hodnotu null.

MutationRecord.oldValue obsahuje předchozí hodnotu atributu pouze tehdy, když je zapnuto attributeOldValue, nebo předchozí data CharacterData pouze tehdy, když je zapnuto characterDataOldValue. Zároveň je nutné sledovat odpovídající druh změny. V ostatních případech, včetně "childList", má hodnotu null; také u atributu, který dříve neexistoval, může být stará hodnota null.

Příklad sleduje odpojený element a synchronně čte záznamy pomocí takeRecords(), která vyprázdní frontu. Není tedy třeba čekat na funkci zpětného volání. Po načtení záznamů observer odpojí.

Pří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ýsledek

["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ýsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje