errorCaptured Capturar erros de descendentes
Última atualização: 2026-10-22
errorCaptured Capturar erros de descendentes
errorCaptured captura erros de componentes descendentes; retornar false interrompe a propagação ao handler global.
| Grupo | Opções: Renderização e Ciclo de Vida |
|---|---|
| Tipo | Opção |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
export default {
errorCaptured(err, vm, info) {
return false // stop propagation
}
}⚙️ Argumentos
| value | err, vm e uma string info descrevendo a origem |
|---|
Retorno：Retorne false para interromper a propagação
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'caught: child failed to initialise' without a blank screen.💡 Pontos-chave
💡 Dica Capture no topo e reporte ao monitoramento.
⚠️ Aviso Apenas erros síncronos — trate rejeições de promise por conta própria.
ℹ️ Nota Os erros borbulham primeiro até o boundary mais próximo.
🏷️ Renderização e Ciclo de Vida relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Dá para capturar erros assíncronos?
R Não — apenas os síncronos.
P Relação com o errorHandler global?
R Retorne false para interrompê-lo localmente; caso contrário, o erro chega ao handler global.
P Como construir UI de fallback?
R Defina o estado ao capturar e troque para uma view de fallback com v-if.
