KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

MutationRecord — een record van een DOM-wijziging

MutationRecord beschrijft één waargenomen DOM-wijziging. Leer hoe je het type en de betrokken node bepaalt, toegevoegde en verwijderde nodes bekijkt en de naam van een attribuut en de vorige waarde ophaalt.

Versie: 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 is een alleen-lezeninterface die een DOM-wijziging beschrijft die door een MutationObserver is waargenomen. Records worden doorgegeven in de array die aan de callback van de observer wordt meegegeven; wachtende records kun je ook ophalen met takeRecords(). Dit is een DOM-API en geen onderdeel van ECMAScript zelf. MDN classificeert deze API sinds juli 2015 als breed beschikbaar in browsers; het gebruik van Node 24 in een project bewijst niet dat deze browser-API wordt ondersteund.

MutationRecord.type is "attributes", "characterData" of "childList". MutationRecord.target verwijst respectievelijk naar het element waarvan het attribuut is gewijzigd, de gewijzigde CharacterData-node of de node waarvan de lijst met kinderen is gewijzigd — niet naar het toegevoegde of verwijderde kind.

MutationRecord.addedNodes en MutationRecord.removedNodes zijn NodeList-objecten met de nodes die door die wijziging zijn toegevoegd en verwijderd. Elke lijst is leeg als er geen overeenkomstige nodes zijn. MutationRecord.attributeName bevat bij "attributes" de naam van het gewijzigde attribuut en is bij andere typen null.

MutationRecord.oldValue bevat de vorige attribuutwaarde alleen als attributeOldValue is ingeschakeld, of de vorige CharacterData-gegevens alleen als characterDataOldValue is ingeschakeld. Ook moet het overeenkomstige soort wijziging worden geobserveerd. In andere gevallen, waaronder "childList", is de waarde null; ook een attribuut dat eerder niet bestond kan een oude waarde null hebben.

Het voorbeeld observeert een losgekoppeld element en leest de records synchroon uit met takeRecords(), waarmee de wachtrij wordt leeggemaakt. Daardoor hoef je niet op de callback te wachten. Nadat de records zijn opgehaald, wordt de observer losgekoppeld.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen