isProxy() Verificar se é um objeto proxy
Última atualização: 2026-10-22
isProxy() Verificar se é um objeto proxy
isProxy() verifica se um valor é um proxy criado por reactive() ou readonly().
| Grupo | Reatividade: Utilitários |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
isProxy(reactive({})) // true
isProxy(readonly({})) // true
isProxy(ref(1)) // false⚙️ Argumentos
| value | Qualquer valor |
|---|
Retorno：Booleano
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'reactive is a proxy: true, readonly is a proxy: true'.💡 Pontos-chave
ℹ️ Nota isReactive só reconhece proxies graváveis, isReadonly só reconhece proxies somente leitura; isProxy reconhece ambos.
💡 Dica Para verificar “é uma fonte reativa”, prefira a combinação de isProxy + isRef.
🏷️ Utilitários relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Um ref também conta como proxy?
R Não: um ref é um objeto wrapper independente (só o valor interno é proxy); isProxy(ref(1)) devolve false.
P Onde isso é usado em projetos reais?
R Ao escrever bibliotecas utilitárias ou depurar, para distinguir objetos comuns de objetos reativos e evitar empacotamento duplicado.
P É o mesmo que instanceof Proxy?
R Não: um Proxy não pode ser detectado com instanceof; é preciso usar as funções de verificação fornecidas pelo Vue.
