Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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}]
0

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori