mutationobserver

Observe DOM changes via the MutationObserver API.

Import: @rtorcato/browser-common/mutationobserver

📖 MDN: MutationObserver · 📊 caniuse: mutationobserver

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
MutationObserver	✅ 26+	✅ 12+	✅ 14+	✅ 7+	✅ 7+	Widely available

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: MutationObserver

Example

import {
  observeMutations,
  disconnectMutationObserver,
  observeMutationOnce,
} from '@rtorcato/browser-common/mutationobserver'

const obs = observeMutations(document.body, (records) => console.log(records))
disconnectMutationObserver(obs)

observeMutationOnce(container, () => console.log('mutated once'))

Exports

• observeMutations(element, callback, options?) — observes an element, returns the MutationObserver
• disconnectMutationObserver(observer) — stops an observer
• observeMutationOnce(element, callback, options?) — observes and auto-disconnects after the first mutation

See the API reference for full signatures.