O erro "MutationEvent is not defined" ocorre frequentemente em scripts que utilizam uma funcionalidade JavaScript desatualizada para monitorizar mudanças no DOM (Document Object Model) das páginas web. Este erro surge devido ao facto de MutationEvent estar obsoleto e já não ser suportado nos principais navegadores modernos, incluindo o Google Chrome e o Microsoft Edge.

O que é o MutationEvent e por que foi descontinuado?

MutationEvent era utilizado para monitorizar alterações em elementos HTML, mas a sua obsolescência trouxe à tona o MutationObserver, uma API mais eficiente para lidar com estas mesmas necessidades.

Causas e Solução do Problema

Causas Prováveis do Erro

  • Scripts desatualizados, frequentemente presentes em bibliotecas ou plugins de terceiros.
  • Funcionalidades específicas que requerem monitorização de mudanças no DOM, mas que utilizam MutationEvent em vez de MutationObserver.

Solução Rápida para Usuários do Google Chrome e Microsoft Edge

Para corrigir este problema temporariamente, os navegadores possuem uma opção experimental que pode ser ativada:

  • Abra o navegador Chrome ou Edge.
  • Na barra de endereço, digite chrome://flags (para Chrome) ou edge://flags (para Edge).
  • Na pesquisa de opções, insira "Mutation" e defina a opção correspondente como Enable.
  • Reinicie o navegador para aplicar as mudanças.

Solução Permanente para Desenvolvedores

Para ajudar os desenvolvedores a implementar uma solução moderna, aqui fica um exemplo de como utilizar o MutationObserver: 

// Alvo e configurações para observar as mudanças no DOM
const alvo = document.getElementById('elemento-alvo');
const configuracoes = { attributes: true, childList: true, subtree: true };

// Callback para o MutationObserver
const callback = (mutacoes) => {
    mutacoes.forEach((mutacao) => {
        if (mutacao.type === 'childList') {
            console.log('Alteração na lista de filhos.');
        }
    });
};

// Inicia o observador
const observador = new MutationObserver(callback);
observador.observe(alvo, configuracoes);

Vídeo Prático de Resolução

Ao seguir estes passos, poderá evitar o erro MutationEvent is not defined, permitindo que os seus scripts continuem a funcionar corretamente nos navegadores modernos.