nextTick() Aguardar a atualização do DOM
Última atualização: 2026-10-22
nextTick() Aguardar a atualização do DOM
nextTick() retorna uma Promise que resolve após a próxima atualização do DOM — use para ler o DOM atualizado logo depois de mudar o estado.
| Grupo | API Global |
|---|---|
| Tipo | API |
| Escopo | Global |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
await nextTick()
console.log(el.value.textContent) // já atualizado⚙️ Argumentos
| callback? | Um callback opcional (prefira await em código novo) |
|---|
Retorno：Uma Promise que resolve depois que o DOM atualiza
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Clicking confirms the DOM already shows the new value.💡 Pontos-chave
ℹ️ Nota O Vue agrupa as atualizações do DOM de forma assíncrona — é por isso que ele existe.
💡 Dica Várias mudanças no mesmo tick são aplicadas de uma só vez.
⚠️ Aviso Prefira watchPostEffect para sincronização contínua.
🏷️ API Global relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Por que o DOM fica atrasado em relação à minha mudança?
R As atualizações são agrupadas em uma microtask — faça await nextTick.
P Qual a diferença em relação a setTimeout?
R nextTick roda antes e de forma determinística.
P O mesmo helper na Composition API?
R Sim — ele é independente de estilo.
