hasInjectionContext() Verificar se é seguro fazer inject
Última atualização: 2026-10-22
hasInjectionContext() Verificar se é seguro fazer inject
hasInjectionContext() verifica se o contexto atual permite usar inject (dentro do setup ou do componente); é uma verificação prévia ao escrever funções utilitárias compartilhadas.
| Grupo | Injeção de Dependência |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.3+ |
| Suporte a SSR | Sim |
📝 Sintaxe
if (hasInjectionContext()) {
const cfg = inject('config')
}Retorno：Booleano
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'Context available: true'.💡 Pontos-chave
ℹ️ Nota Ao escrever bibliotecas/funções utilitárias, primeiro sonda o contexto para evitar chamar inject em ambiente não componente e disparar avisos.
⚠️ Aviso Só existe a partir do 3.3+; em projetos com versões anteriores, substitua por try/catch dentro do setup ou por passagem explícita de parâmetros.
🏷️ Injeção de Dependência relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P O que acontece sem ele?
R Chamar inject fora de ambiente de componente retorna um aviso e undefined, e a lógica pode falhar silenciosamente.
P Quem são os usuários típicos?
R Bibliotecas de componentes e funções utilitárias combináveis: precisam tanto suportar configuração injetada quanto rodar em ambiente JS puro.
P Equivale a estar dentro do setup?
R Aproximadamente: qualquer contexto em tempo de execução que permita inject retorna true (incluindo composables rodando dentro de effectScope).
