isRef() Verificar se um valor é um ref
Última atualização: 2026-10-22
isRef() Verificar se um valor é um ref
isRef() verifica se um valor é um objeto ref; é comum em funções utilitárias para distinguir valores comuns de referências reativas.
| Grupo | Reatividade: Utilitários |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
isRef(count) // true
isRef(0) // false
isRef(reactive({})) // false (isso é um proxy reativo)⚙️ Argumentos
| value | Qualquer valor |
|---|
Retorno：Booleano
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'a ref / a plain value / a plain value'.💡 Pontos-chave
💡 Dica Ao escrever funções utilitárias, primeiro verifique com isRef para decidir se deve acessar .value, evitando obrigar quem chama a sempre passar um ref.
ℹ️ Nota Um proxy reactive não é um ref; refs aninhados dentro de objetos são desembrulhados automaticamente.
🏷️ Utilitários relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Quando preciso dele?
R Ao escrever funções utilitárias reutilizáveis (o parâmetro pode ser um ref ou um valor comum) ou ao confirmar o tipo de uma variável na depuração.
P isRef e isReactive se sobrepõem?
R Não: o wrapper de ref e o proxy reactive são duas famílias de objetos, cada uma com seu próprio teste.
P É preciso verificar nos templates?
R Não é preciso: o template desembrulha refs automaticamente — use-os como valores comuns.
