re:re:actable
Урок 191 минута чтения

Как работает MutationObserver?

На этой странице
Кратко

MutationObserver асинхронно наблюдает за изменениями DOM: добавлением узлов, изменением атрибутов и текста.

Вопрос

Как отследить изменения в DOM?

Определение

MutationObserver - Web API, который сообщает о мутациях DOM. Он не блокирует выполнение кода и вызывает callback после изменений, передавая список MutationRecord.

Пример

const target = document.querySelector('.list');
 
const observer = new MutationObserver((mutations) => {
  mutations.forEach((mutation) => {
    console.log(mutation.type);
  });
});
 
observer.observe(target, {
  childList: true,
  attributes: true,
  subtree: true,
});

Что можно отслеживать

ОпцияЧто отслеживает
childListдобавление и удаление дочерних узлов
attributesизменение атрибутов
characterDataизменение текстовых узлов
subtreeнаблюдение за всем поддеревом

Пример MutationRecord

observer.observe(target, { childList: true });
 
target.append(document.createElement('li'));

В callback придет запись о добавленном узле.

Остановка наблюдения

observer.disconnect();

Важно отключать observer, когда он больше не нужен, чтобы не держать лишние ссылки и не выполнять ненужную работу.

Что важно помнить

  • Колбэк MutationObserver вызывается как микрозадача с пачкой изменений.
  • Изменение DOM внутри колбэка может вызвать бесконечный цикл наблюдения.
  • Наблюдайте только нужное (childList, attributes, subtree) — полное наблюдение за документом дорого.
  • Для отслеживания размеров используйте ResizeObserver, а не MutationObserver.

Мини-шпаргалка

const observer = new MutationObserver(callback);
observer.observe(element, options);
observer.disconnect();

Документация

MDN: MutationObserver, learn.javascript.ru: MutationObserver.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам