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}]
0Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.