CKTIS / JavaScript
MutationRecord — zapis o promjeni DOM-a
MutationRecord opisuje jednu zabilježenu promjenu DOM-a. Saznajte kako odrediti njezinu vrstu i zahvaćeni čvor, pregledati dodane i uklonjene čvorove te dohvatiti naziv atributa i njegovu prethodnu vrijednost.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
record.type; record.target; record.addedNodes; record.removedNodes; record.attributeName; record.oldValueMutationRecord je sučelje samo za čitanje koje opisuje promjenu DOM-a zabilježenu pomoću MutationObserver. Zapisi se prosljeđuju u polju koje prima povratna funkcija promatrača; zapise na čekanju možete dohvatiti i pomoću takeRecords(). To je API DOM-a, a ne dio samog ECMAScripta. MDN ga svrstava među široko dostupne u preglednicima od srpnja 2015.; prisutnost Nodea 24 u projektu ne dokazuje podršku za ovaj API preglednika.
MutationRecord.type ima vrijednost "attributes", "characterData" ili "childList". MutationRecord.target označava element čiji se atribut promijenio, promijenjeni čvor CharacterData ili čvor čiji se popis djece promijenio — ne dodano ili uklonjeno dijete.
MutationRecord.addedNodes i MutationRecord.removedNodes objekti su NodeList koji sadrže čvorove dodane odnosno uklonjene tom promjenom. Ako nema odgovarajućih čvorova, popis je prazan. MutationRecord.attributeName sadrži naziv promijenjenog atributa za "attributes", a za ostale je vrste null.
MutationRecord.oldValue sadrži prethodnu vrijednost atributa samo ako je uključen attributeOldValue, odnosno prethodne podatke CharacterData samo ako je uključen characterDataOldValue. Mora se pratiti i odgovarajuća vrsta promjene. U ostalim slučajevima, uključujući "childList", vrijednost je null; i atribut koji prije nije postojao može imati prethodnu vrijednost null.
Primjer promatra odspojeni element i sinkrono čita zapise pomoću takeRecords(), koja prazni red čekanja. Zato nije potrebno čekati povratnu funkciju. Nakon dohvaćanja zapisa prekida vezu s promatračem.
Primjeri
(() => {
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
]));
}
})();Rezultat
["attributes",true,0,0,"data-state","idle"] ["childList",true,1,0,null,null] ["childList",true,0,1,null,null]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.