Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zobrazený 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.

Zdroje