Урок 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.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.