Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MutationObserver — opazovanje sprememb DOM

MutationObserver beleži izbrane spremembe DOM in zapise asinhrono posreduje funkciji povratnega klica. Preberite, kako observe() nastavi opazovanje, takeRecords() izprazni čakalno vrsto in disconnect() ustavi opazovanje.

Različica: 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 je API standarda DOM, ne pa del samega ECMAScripta. Funkcija povratnega klica prejme polje objektov MutationRecord in opazovalnik. Obvestilo se uvrsti v čakalno vrsto kot mikronaloga in ni dostavljeno sinhrono med spremembo; en klic lahko vsebuje več zapisov. Prisotnost Node 24 v repozitoriju ne potrjuje razpoložljivosti tega brskalniškega API-ja.

MutationObserver.observe, klican kot observer.observe(target, options), izbere vozlišče in vrste sprememb: childList spremlja dodajanje in odstranjevanje otrok, attributes spremlja atribute, characterData pa podatke besedilnih in podobnih vozlišč. subtree: true vključuje potomce. Po uporabi privzetih vrednosti mora biti omogočena vsaj ena vrsta; sicer se sproži TypeError. attributeFilter omeji imena atributov; attributeOldValue in characterDataOldValue zahtevata prejšnje vrednosti. Možnosti za atribute ali podatke lahko ustrezno vrsto opazovanja omogočijo implicitno, vendar izrecno nasprotujoče si nastavitve sprožijo TypeError.

MutationObserver.takeRecords, klican kot observer.takeRecords(), sinhrono vrne čakajoče zapise in izprazni čakalno vrsto, ne da bi priklical funkcijo povratnega klica ali ustavil opazovanje. MutationObserver.disconnect, klican kot observer.disconnect(), ustavi vsa opazovanja tega objekta in zavrže čakajoče zapise. Če jih potrebujete, jih najprej pridobite. Objekt lahko znova zaženete z observe().

Primer opazuje odklopljen element, pridobi njegov zapis pred dostavo obvestila in ustavi opazovanje. oldValue je null, ker atribut prej ni obstajal. Obseg opazovanja naj bo omejen; spremembe, ki jih izvede funkcija povratnega klica, lahko povzročijo dodatna obvestila.

Primeri

{
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri