CKTIS / JavaScript
MutationObserver — sledování změn DOM
MutationObserver zaznamenává vybrané změny DOM a předává záznamy asynchronně zpětnému volání. Zjistěte, jak observe() nastavuje sledování, takeRecords() vyprazdňuje frontu a disconnect() sledování zastavuje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const observer = new MutationObserver((records, observer) => { /* handle records */ });
observer.observe(target, options);
const pending = observer.takeRecords();
observer.disconnect();MutationObserver je API standardu DOM, nikoli samotného ECMAScriptu. Zpětné volání dostává pole objektů MutationRecord a observer. Oznámení se zařadí do fronty jako mikroúloha a nepředává se synchronně během změny; jedno volání může obsahovat více záznamů. Přítomnost Node 24 v repozitáři nedokládá dostupnost tohoto API prohlížeče.
MutationObserver.observe, volané jako observer.observe(target, options), vybírá uzel a typy změn: childList sleduje přidávání a odebírání potomků, attributes sleduje atributy a characterData data textových a podobných uzlů. subtree: true zahrnuje potomky. Po použití výchozích hodnot musí být povolen alespoň jeden typ; jinak se vyvolá TypeError. attributeFilter omezuje názvy atributů; attributeOldValue a characterDataOldValue vyžadují předchozí hodnoty. Volby týkající se atributů nebo dat mohou odpovídající typ sledování implicitně povolit, ale výslovně rozporné nastavení vyvolá TypeError.
MutationObserver.takeRecords, volané jako observer.takeRecords(), synchronně vrací čekající záznamy a vyprázdní frontu, aniž zavolá zpětné volání nebo zastaví sledování. MutationObserver.disconnect, volané jako observer.disconnect(), zastaví všechna sledování tohoto objektu a zahodí čekající záznamy. Pokud je potřebujete, nejprve je vyzvedněte. Objekt lze znovu spustit pomocí observe().
Příklad sleduje odpojený prvek, vyzvedne jeho záznam před doručením oznámení a sledování zastaví. oldValue je null, protože atribut dříve neexistoval. Omezte rozsah sledování; změny provedené zpětným voláním mohou vytvářet další oznámení.
Pří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ýsledek
[{"type":"attributes","attributeName":"data-state","oldValue":null}]
0Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.