Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

MutationObserver — sledovanie zmien DOM

MutationObserver zaznamenáva vybrané zmeny DOM a odovzdáva záznamy asynchrónne funkcii spätného volania. Zistite, ako observe() nastavuje sledovanie, takeRecords() vyprázdňuje front a disconnect() sledovanie zastaví.

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

Syntax

const observer = new MutationObserver((records, observer) => { /* handle records */ });
observer.observe(target, options);
const pending = observer.takeRecords();
observer.disconnect();

MutationObserver je API štandardu DOM, nie samotného ECMAScriptu. Funkcia spätného volania dostáva pole objektov MutationRecord a observer. Oznámenie sa zaradí do frontu ako mikróúloha a nedoručuje sa synchrónne počas zmeny; jedno volanie môže obsahovať viacero záznamov. Prítomnosť Node 24 v repozitári nepotvrdzuje dostupnosť tohto API prehliadača.

MutationObserver.observe, volané ako observer.observe(target, options), vyberá uzol a typy zmien: childList sleduje pridávanie a odoberanie potomkov, attributes sleduje atribúty a characterData údaje textových a podobných uzlov. subtree: true zahŕňa potomkov. Po použití predvolených hodnôt musí byť povolený aspoň jeden typ; inak sa vyvolá TypeError. attributeFilter obmedzuje názvy atribútov; attributeOldValue a characterDataOldValue požadujú predchádzajúce hodnoty. Voľby týkajúce sa atribútov alebo údajov môžu príslušný typ sledovania implicitne povoliť, ale výslovne rozporné nastavenia vyvolajú TypeError.

MutationObserver.takeRecords, volané ako observer.takeRecords(), synchrónne vráti čakajúce záznamy a vyprázdni front bez zavolania funkcie spätného volania alebo zastavenia sledovania. MutationObserver.disconnect, volané ako observer.disconnect(), zastaví všetky sledovania tohto objektu a zahodí čakajúce záznamy. Ak ich potrebujete, najprv ich získajte. Objekt možno znova spustiť pomocou observe().

Príklad sleduje odpojený prvok, získa jeho záznam pred doručením oznámenia a zastaví sledovanie. oldValue je null, pretože atribút predtým neexistoval. Obmedzte rozsah sledovania; zmeny vykonané funkciou spätného volania môžu vytvárať ďalšie oznámenia.

Príklady

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

Výsledok

[{"type":"attributes","attributeName":"data-state","oldValue":null}]
0

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje