База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

MutationRecord — запис за промяна в DOM

MutationRecord описва една наблюдавана промяна в DOM. Научете как да определите типа и засегнатия възел, да разгледате добавените и премахнатите възли и да получите името на атрибут и предишната му стойност.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

MutationRecord е интерфейс само за четене, който описва промяна в DOM, наблюдавана чрез MutationObserver. Записите се подават в масива, предаден на функцията за обратно извикване на наблюдателя; чакащите записи могат да се получат и с takeRecords(). Това е API на DOM, а не част от самия ECMAScript. MDN го класифицира като широко достъпно в браузърите от юли 2015 г.; наличието на Node 24 в даден проект не доказва поддръжка на това API на браузъра.

MutationRecord.type е "attributes", "characterData" или "childList". MutationRecord.target обозначава съответно елемента, чийто атрибут е променен, променения възел CharacterData или възела, чийто списък с деца е променен — не добавеното или премахнатото дете.

MutationRecord.addedNodes и MutationRecord.removedNodes са обекти NodeList, съдържащи възлите, добавени и премахнати при тази промяна. Ако няма съответни възли, списъкът е празен. MutationRecord.attributeName съдържа името на променения атрибут при "attributes", а при останалите типове е null.

MutationRecord.oldValue съдържа предишната стойност на атрибута само когато е включено attributeOldValue, или предишните данни на CharacterData само когато е включено characterDataOldValue. Трябва да се наблюдава и съответният вид промяна. В останалите случаи, включително при "childList", стойността е null; при атрибут, който преди това не е съществувал, предишната стойност също може да е null.

Примерът наблюдава отделен от документа елемент и синхронно прочита записите чрез takeRecords(), което изпразва опашката. Така не се налага да се чака функцията за обратно извикване. След като получи записите, примерът прекъсва връзката с наблюдателя.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници