Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MutationRecord: un registro de cambios del DOM

MutationRecord describe un único cambio observado en el DOM. Aprende a identificar su tipo y el nodo afectado, consultar los nodos añadidos y eliminados, y obtener el nombre de un atributo y su valor anterior.

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

Sintaxis

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

MutationRecord es una interfaz de solo lectura que describe un cambio del DOM observado por un MutationObserver. Los registros se reciben en el array que se pasa a la función de retorno del observador; también se pueden obtener los registros pendientes con takeRecords(). Es una API del DOM, no forma parte de ECMAScript. MDN la clasifica como ampliamente disponible en los navegadores desde julio de 2015; que un proyecto use Node 24 no demuestra que sea compatible con esta API del navegador.

MutationRecord.type vale "attributes", "characterData" o "childList". MutationRecord.target identifica, respectivamente, el elemento cuyo atributo cambió, el nodo CharacterData modificado o el nodo cuya lista de hijos cambió; no identifica el hijo añadido o eliminado.

MutationRecord.addedNodes y MutationRecord.removedNodes son objetos NodeList que contienen los nodos añadidos y eliminados por ese cambio. Cada lista está vacía si no hay nodos correspondientes. MutationRecord.attributeName contiene el nombre del atributo modificado para "attributes" y es null para los demás tipos.

MutationRecord.oldValue contiene el valor anterior del atributo solo si está activado attributeOldValue, o los datos anteriores de CharacterData solo si está activado characterDataOldValue. También hay que observar el tipo de cambio correspondiente. En los demás casos, incluido "childList", su valor es null; un atributo que antes no existía también puede tener un valor anterior null.

El ejemplo observa un elemento desconectado y lee los registros de forma síncrona mediante takeRecords(), que vacía la cola. Así no hace falta esperar a la función de retorno. Después de obtener los registros, desconecta el observador.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes