Files
eewing cf73cd3b4c INIT
2026-02-17 14:10:16 -06:00

39 lines
1.2 KiB
JavaScript

import { extract } from "../extract/extract.svelte.js";
import { defaultWindow } from "../../internal/configurable-globals.js";
/**
* Watch for changes being made to the DOM tree.
*
* @see https://runed.dev/docs/utilities/useMutationObserver
* @see https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver MutationObserver MDN
*/
export function useMutationObserver(target, callback, options = {}) {
const { window = defaultWindow } = options;
let observer;
const targets = $derived.by(() => {
const value = extract(target);
return new Set(value ? (Array.isArray(value) ? value : [value]) : []);
});
const stop = $effect.root(() => {
$effect(() => {
if (!targets.size || !window)
return;
observer = new window.MutationObserver(callback);
for (const el of targets)
observer.observe(el, options);
return () => {
observer?.disconnect();
observer = undefined;
};
});
});
$effect(() => {
return stop;
});
return {
stop,
takeRecords() {
return observer?.takeRecords();
},
};
}