CKTIS / JavaScript
MutationObserver: observe(), disconnect() in takeRecords()
Opazuj izbrane spremembe v DOM-u, prevzemi čakajoče zapise brez čakanja na povratni klic in se ob koncu opazovanja odloči, ali jih boš obdržal.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const observer = new MutationObserver(callback);
observer.observe(target, options);
const records = observer.takeRecords();
observer.disconnect();new MutationObserver(callback) ustvari opazovalnik, vendar še ne začne opazovanja. observe(target, options), disconnect() in takeRecords() so metode primerka, ne statične metode. Ustrezne spremembe se postavijo v čakalno vrsto; mikroopravilo za obveščanje jih v paketu posreduje funkciji callback(records, observer), namesto da bi jo sinhrono poklicalo ob vsaki spremembi.
observe(target, options) registrira vozlišče DOM (Node) in vrne undefined. Z nadaljnjimi klici lahko dodaš druge cilje ali posodobiš možnosti za isti cilj. childList opazuje dodajanje in odstranjevanje neposrednih otrok, attributes spremembe atributov, characterData pa spremembe podatkov vozlišča, denimo vsebine besedilnega vozlišča. subtree: true uporabi enaka pravila tudi za potomce. Spremembe v odstranjeni veji se lahko uvrstijo v čakalno vrsto še pred naslednjim mikroopravilom za obveščanje.
attributeFilter omeji imena opazovanih atributov. attributeOldValue: true in characterDataOldValue: true shranita prejšnjo vrednost v oldValue. Če izpustiš attributes, že navedba attributeFilter ali attributeOldValue vključi opazovanje atributov. Navedba characterDataOldValue podobno vključi izpuščeno možnost characterData. observe() sproži TypeError, če ni omogočena nobena vrsta sprememb, če združiš attributes: false s filtrom ali z attributeOldValue: true ali če združiš characterData: false s characterDataOldValue: true.
takeRecords() sinhrono vrne polje čakajočih objektov MutationRecord ([], če je vrsta prazna) in izprazni vrsto. Ne ustavi opazovanja in ne izvede povratnega klica; vrnjene zapise obdelaš samostojno. disconnect() vrne undefined, ustavi opazovanje vseh ciljev tega primerka in zavrže nedostavljene zapise. Če jih želiš obdržati, pokliči takeRecords() tik pred disconnect(). Z novim klicem observe() lahko opazovalnik znova uporabiš.
To je API DOM-a spletne platforme in ni del ECMAScripta 2024. Razpoložljivost je odvisna od izvajalnega okolja. Opazovalnik ne omogoča dostopa do sicer nedostopnih vozlišč, na primer znotraj iframe z drugim izvorom.
Primeri
<!doctype html>
<meta charset="utf-8">
<title>MutationObserver example</title>
<script>
const target = document.createElement('div');
const options = { attributes: true, attributeFilter: ['data-state'] };
const observer = new MutationObserver((records, currentObserver) => {
console.log(`callback: ${records.length} ${records[0].attributeName}`);
currentObserver.disconnect();
});
observer.observe(target, options);
target.setAttribute('data-state', 'first');
const [record] = observer.takeRecords();
console.log(`taken: ${record.type} ${record.attributeName}`);
target.setAttribute('data-state', 'discarded');
observer.disconnect();
target.setAttribute('data-state', 'unobserved');
console.log(`remaining: ${observer.takeRecords().length}`);
observer.observe(target, options);
target.setAttribute('data-state', 'delivered');
</script>Rezultat
taken: attributes data-state remaining: 0 callback: 1 data-state
Celoten primer shrani kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Element ni dodan strani. `takeRecords()` prevzame prvi zapis, `disconnect()` zavrže drugega, sprememba med prekinitvijo pa se ne zabeleži. Povratni klic prejme samo spremembo po ponovnem začetku opazovanja.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednja · Različica: 3