onUnmounted() Hook de conclusão da desmontagem
Última atualização: 2026-10-22
onUnmounted() Hook de conclusão da desmontagem
onUnmounted() é chamado depois que o componente é destruído, o DOM removido e todos os efeitos colaterais reativos são interrompidos.
| Grupo | Hooks de Ciclo de Vida |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
onUnmounted(() => {
// componente totalmente destruído, limpe recursos externos
})⚙️ Argumentos
| callback | Função executada após a desmontagem |
|---|
Retorno：Nada
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Toggling the child off logs 'child unmounted'.💡 Pontos-chave
ℹ️ Nota O Vue interrompe automaticamente os observadores e efeitos colaterais do componente; aqui só é preciso tratar os recursos externos que o framework não alcança.
⚠️ Aviso Ler o DOM neste momento não é confiável (pode já ter sido removido).
💡 Dica Em cenários de múltiplas instâncias, limpe sempre os listeners globais: caso contrário, os callbacks de cada instância destruída continuam rodando.
🏷️ Hooks de Ciclo de Vida relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Ainda é preciso parar o watch manualmente?
R Não: os efeitos criados dentro do componente param automaticamente quando o componente é destruído (exceto os de escopos desanexados).
P Como escolher entre onUnmounted e onBeforeUnmount?
R Limpeza de lógica pura usa onUnmounted; limpeza que precisa ler o DOM deve ir em onBeforeUnmount.
P Executa sob SSR?
R Hooks de desmontagem não executam na renderização do servidor; eles acontecem apenas no navegador.
