CKTIS / JavaScript
Opcije MutationObserver: vrste promjena, podstablo, filtar i prethodne vrijednosti
Pomoću `observe()` postavi praćenje promjena čvorova djece, atributa ili znakovnih podataka. Odaberi opseg praćenja i odredi kada zapis treba sadržavati prethodnu vrijednost.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const observer = new MutationObserver((records, observer) => {
for (const record of records) {
// Read record.type, record.target, or record.oldValue.
}
});
observer.observe(target, {
childList: true,
attributes: true,
characterData: true,
subtree: true,
attributeFilter: ["data-state"],
attributeOldValue: true,
characterDataOldValue: true,
});new MutationObserver(callback) stvara promatrača; observer.observe(target, options) pokreće praćenje čvora DOM-a. Povratna funkcija prima niz objekata MutationRecord i promatrača. To je DOM API web-platforme, a ne dio ECMAScripta 2024; dostupnost ovisi o okruženju za izvršavanje.
childList prijavljuje dodavanje ili uklanjanje izravne djece praćenog čvora (addedNodes, removedNodes). attributes prijavljuje dodavanje, promjenu ili uklanjanje atributa elementa. characterData prijavljuje izmjene postojećeg čvora CharacterData, primjerice promjenu text.data. Dodjela vrijednosti svojstvu textContent elementa zamjenjuje njegovu djecu. Ako se popis djece promijeni, prijavljuje se childList, a ne characterData. subtree: true proširuje praćenje odabranih vrsta promjena na potomke; prema zadanim postavkama prati se samo target.
attributeFilter navodi lokalna imena atributa, a ne CSS selektore. Kada postoji filtar, podudaraju se samo navedeni atributi bez imenskog prostora; bez filtra uzimaju se u obzir svi atributi. attributeOldValue: true i characterDataOldValue: true pohranjuju vrijednost prije odgovarajuće promjene u svojstvo record.oldValue, koje je samo za čitanje. Ne postoji opcija oldValue ni polje newValue. oldValue je null za childList, ako prethodna vrijednost nije zatražena ili ako atribut prije nije postojao.
childList je prema zadanim postavkama false. Ako izostaviš attributes, postaje true kad navedeš attributeFilter ili attributeOldValue; ako izostaviš characterData, postaje true kad navedeš characterDataOldValue. Za opciju prethodne vrijednosti dovoljna je njezina prisutnost, čak i s vrijednošću false. Inače su obje vrste zadano isključene. observe() baca TypeError ako nijedna vrsta nije uključena, ako se attributes: false kombinira s filtrom ili s attributeOldValue: true ili ako se characterData: false kombinira s characterDataOldValue: true.
Zapisi stižu povratnoj funkciji u skupinama u mikrozadatku, a ne tijekom same promjene DOM-a. Uz subtree: true privremene registracije omogućuju daljnje praćenje podstabla uklonjenog potomka. Mikrozadatak za obavješćivanje uklanja te registracije pri obradi promatrača, prije mogućeg poziva povratne funkcije. Uklanjanje registracija ne ovisi o isporuci zapisa o uklanjanju čvora: childList može biti isključen ili je takeRecords() možda već ispraznio red čekanja. disconnect() prekida praćenje i odbacuje zapise na čekanju. Ako ih trebaš, prvo ih preuzmi pozivom takeRecords(), koji prazni red čekanja.
Primjeri
<!doctype html>
<meta charset="utf-8">
<title>MutationObserver options</title>
<script>
const root = document.createElement("div");
const item = document.createElement("span");
const text = document.createTextNode("before");
item.setAttribute("data-state", "idle");
item.append(text);
root.append(item);
const observer = new MutationObserver((records, self) => {
for (const record of records) {
console.log(JSON.stringify([record.type, record.attributeName, record.oldValue]));
}
self.disconnect();
});
observer.observe(root, {
childList: true,
subtree: true,
attributeFilter: ["data-state"],
attributeOldValue: true,
characterDataOldValue: true,
});
item.setAttribute("data-state", "ready");
item.setAttribute("title", "ignored");
text.data = "after";
item.append(document.createElement("em"));
</script>Rezultat
["attributes","data-state","idle"] ["characterData",null,"before"] ["childList",null,null]
Spremi cijeli primjer kao datoteku `.html` i otvori je u pregledniku. Otvori razvojnu konzolu i ponovno učitaj stranicu. Čvorovi se ne umeću u stranicu. Filtar isključuje `title`, a opcije za prethodne vrijednosti uključuju izostavljene opcije `attributes` i `characterData`. Povratna funkcija ispisuje tri zapisa redoslijedom promjena, a zatim prekida praćenje.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednje · Verzija: 3
Izvori
- MutationObserver: observe() method
- MutationObserver: MutationObserver() constructor
- MutationRecord
- MutationRecord: oldValue property
- Node: textContent property
- Using microtasks in JavaScript with queueMicrotask()
- HTML Standard — Event loops
- MutationObserver: disconnect() method
- MutationObserver: takeRecords() method