O HMR (Hot Module Replacement) é um mecanismo que aplica atualizações de módulos a uma aplicação em execução sem recarregar a página inteira. No desenvolvimento web, ele permite conferir uma edição no navegador e pode preservar o estado das partes que continuam abertas.
Um módulo é uma unidade de código carregada pela aplicação, como o código de um componente. Quando você altera essa unidade, a ferramenta de desenvolvimento disponibiliza uma atualização para a aplicação aberta. O tratamento fornecido pela integração aceita a atualização e aplica a mudança, conforme o suporte do framework.
Alterar o estilo de um formulário
Neste exemplo didático, você preenche um formulário na página local e altera a cor de seu botão no arquivo de estilos. Com o HMR de estilos ativo, o navegador aplica a nova aparência sem abrir o documento novamente. Os campos podem continuar preenchidos porque essa atualização não exige recriar o formulário.
Uma mudança na lógica do componente pode ter outro resultado. A integração pode recriá-lo e perder seu estado, ou recorrer à recarga completa quando não consegue aplicar a alteração pelo mecanismo de atualização. A preservação observada ao editar o estilo não se estende automaticamente a qualquer mudança.
Limpeza dos efeitos do módulo anterior
Um módulo que associa uma função ao clique de um botão pode deixar esse registro ativo após uma atualização. Se a nova versão adicionar outro registro sem remover o anterior, um único clique pode disparar duas chamadas.
No Vite, import.meta.hot.dispose() permite registrar a limpeza dos efeitos persistentes da versão anterior. O tratamento depende do recurso criado pelo módulo, como remover um evento que ele registrou. A documentação dessa interface orienta principalmente o desenvolvimento de ferramentas e integrações.
Você também precisa conferir a página após uma recarga completa. O estado mantido pelo HMR pode esconder uma falha de inicialização que só aparece ao abrir o documento novamente. O build de produção exige sua própria verificação, pois o funcionamento após uma atualização local não comprova o comportamento da versão publicada.
Dúvidas frequentes
Perguntas frequentes sobre HMR
- O HMR mantém os campos de um formulário preenchidos?
- Uma atualização de estilo pode preservar os campos quando a página permanece aberta. Mudanças que recriam o componente ou provocam recarga podem perder esse estado, conforme o framework e a integração.
- Preciso escrever o tratamento das atualizações no Vite?
- Em projetos com uma integração de framework, esse tratamento costuma estar pronto. A interface manual de HMR do Vite se destina principalmente ao desenvolvimento de frameworks e ferramentas.
- O HMR atualiza o site em produção?
- O uso descrito aqui pertence ao servidor de desenvolvimento. Alterar um arquivo e vê-lo atualizado por HMR não comprova que o build de produção foi gerado, testado ou publicado.
Para continuar
Recursos relacionados
Documentação
webpack: substituição de módulos
Explica a obtenção e a aplicação das atualizações de módulos em uma aplicação que continua em execução.
Abrir recursoDocumentação
Vite: API de HMR
Documenta como aceitar atualizações e limpar os efeitos mantidos pela versão anterior de um módulo no Vite.
Abrir recursoAplicação na formação
Developer Workspace
O ambiente de desenvolvimento pode atualizar partes da aplicação durante a edição dos arquivos.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.