CKTIS / JavaScript
MutationObserver: observe(), disconnect() i takeRecords()
Promatraj odabrane promjene u DOM-u, preuzmi zapise na čekanju bez čekanja na povratnu funkciju i odluči hoćeš li ih zadržati kad zaustaviš promatranje.
Verzija: 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) stvara promatrač, ali ne pokreće promatranje. observe(target, options), disconnect() i takeRecords() metode su instance, a ne statičke metode. Odgovarajuće promjene ulaze u red čekanja. Mikrozadatak za obavijesti predaje ih kao skup funkciji callback(records, observer) umjesto da je poziva sinkrono pri svakoj promjeni.
observe(target, options) registrira čvor DOM-a (Node) i vraća undefined. Dodatni pozivi mogu dodati druge ciljeve ili promijeniti opcije za isti cilj. childList prati dodavanje i uklanjanje izravne djece, attributes prati promjene atributa, a characterData promjene podataka čvora, primjerice sadržaja tekstnog čvora. subtree: true primjenjuje ista pravila i na potomke. Promjene u uklonjenoj grani još mogu ući u red prije sljedećeg mikrozadatka za obavijesti.
attributeFilter ograničava nazive atributa koji se prate. attributeOldValue: true i characterDataOldValue: true spremaju prethodnu vrijednost u oldValue. Ako izostaviš attributes, samo navođenje attributeFilter ili attributeOldValue uključuje promatranje atributa. Navođenje characterDataOldValue na isti način uključuje izostavljeni characterData. observe() baca TypeError ako nije uključena nijedna vrsta promjene, ako uz attributes: false zadaš filtar ili attributeOldValue: true ili ako spojiš characterData: false i characterDataOldValue: true.
takeRecords() sinkrono vraća niz objekata MutationRecord koji čekaju ([] ako je red prazan) i prazni red. Ne zaustavlja promatranje i ne poziva povratnu funkciju; vraćene zapise obrađuješ samostalno. disconnect() vraća undefined, zaustavlja promatranje svih ciljeva te instance i odbacuje neisporučene zapise. Ako ih želiš sačuvati, pozovi takeRecords() neposredno prije disconnect(). Promatrač možeš ponovno upotrijebiti pozivom metode observe().
To je API za DOM na web-platformi, nije dio ECMAScripta 2024. Dostupnost ovisi o izvršnom okruženju. Promatrač ne omogućuje pristup inače nedostupnim čvorovima, primjerice unutar iframe elementa drugog podrijetla.
Primjeri
<!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
Spremi cijeli primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u razvojnoj konzoli. Element se ne dodaje na stranicu. `takeRecords()` preuzima prvi zapis, `disconnect()` odbacuje drugi, a promjena tijekom prekida ne bilježi se. Povratna funkcija prima samo promjenu nakon nastavka promatranja.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednje · Verzija: 3