onBeforeUpdate() Hook antes da atualização
Última atualização: 2026-10-22
onBeforeUpdate() Hook antes da atualização
onBeforeUpdate() é chamado quando os dados reativos mudaram e o DOM está prestes a atualizar: neste momento é possível ler o estado do DOM antes da atualização.
| Grupo | Hooks de Ciclo de Vida |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
onBeforeUpdate(() => {
// o DOM ainda está no estado antigo
})⚙️ Argumentos
| callback | Função executada antes da atualização |
|---|
Retorno：Nada
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Each click records the stale DOM first, then the view refreshes.💡 Pontos-chave
ℹ️ Nota Frequência de uso baixa: a maioria das necessidades de leitura antes da atualização pode ser coberta por watch + watchPostEffect.
⚠️ Aviso Alterar dados aqui causa uma rodada extra de atualização e pode facilmente formar um loop; tenha cuidado ao atribuir valores.
🏷️ Hooks de Ciclo de Vida relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Quem vem primeiro — este hook ou a atualização do DOM?
R O hook vem primeiro: a atualização do DOM acontece logo em seguida, então o que se lê aqui é o DOM antigo.
P Dá para impedir a atualização aqui?
R Não, o Vue não oferece mecanismo de cancelamento; para renderização condicional, use v-if.
P Qual a diferença para o flush: 'pre' do watch?
R O momento é o mesmo (antes do DOM), mas o watch observa dados específicos e tem valores antigos e novos; este hook não recebe parâmetros.
