CKTIS / JavaScript
MutationObserver — praćenje promjena DOM-a
MutationObserver bilježi odabrane promjene DOM-a i asinkrono prosljeđuje zapise funkciji povratnog poziva. Saznajte kako observe() konfigurira praćenje, takeRecords() prazni red čekanja, a disconnect() zaustavlja praćenje.
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
const observer = new MutationObserver((records, observer) => { /* handle records */ });
observer.observe(target, options);
const pending = observer.takeRecords();
observer.disconnect();MutationObserver API je standarda DOM, a ne dio samog ECMAScripta. Funkcija povratnog poziva prima polje objekata MutationRecord i promatrač. Obavijest se stavlja u red čekanja kao mikrozadatak i ne isporučuje se sinkrono tijekom promjene; jedan poziv može sadržavati više zapisa. To što se Node 24 nalazi u repozitoriju ne potvrđuje dostupnost ovog API-ja preglednika.
MutationObserver.observe, pozvan kao observer.observe(target, options), odabire čvor i vrste promjena: childList prati dodavanje i uklanjanje djece, attributes prati atribute, a characterData podatke tekstualnih i sličnih čvorova. subtree: true uključuje potomke. Nakon primjene zadanih vrijednosti mora biti omogućena barem jedna vrsta; u suprotnom se pokreće TypeError. attributeFilter ograničava nazive atributa; attributeOldValue i characterDataOldValue traže prethodne vrijednosti. Opcije povezane s atributima ili podacima mogu implicitno omogućiti odgovarajuću vrstu praćenja, ali izričito proturječne postavke uzrokuju TypeError.
MutationObserver.takeRecords, pozvan kao observer.takeRecords(), sinkrono vraća zapise na čekanju i prazni red bez pozivanja funkcije povratnog poziva ili zaustavljanja praćenja. MutationObserver.disconnect, pozvan kao observer.disconnect(), zaustavlja sva praćenja tog objekta i odbacuje zapise na čekanju. Ako su vam potrebni, preuzmite ih prije toga. Objekt se može ponovno pokrenuti pomoću observe().
Primjer prati odvojeni element, preuzima njegov zapis prije isporuke obavijesti i zaustavlja praćenje. oldValue je null jer atribut prije nije postojao. Ograničite opseg praćenja; promjene koje napravi funkcija povratnog poziva mogu proizvesti dodatne obavijesti.
Primjeri
{
const target = document.createElement('div');
const observer = new MutationObserver((records) => {
console.log('callback:', records.length);
});
observer.observe(target, {
attributes: true,
attributeFilter: ['data-state'],
attributeOldValue: true
});
target.setAttribute('data-state', 'ready');
const records = observer.takeRecords();
console.log(JSON.stringify(records.map((record) => ({
type: record.type,
attributeName: record.attributeName,
oldValue: record.oldValue
}))));
observer.disconnect();
target.setAttribute('data-state', 'done');
console.log(observer.takeRecords().length);
}Rezultat
[{"type":"attributes","attributeName":"data-state","oldValue":null}]
0Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.