unref() Extrair o valor de um ref
Última atualização: 2026-10-22
unref() Extrair o valor de um ref
unref() é um atalho para isRef(v) ? v.value : v: se for um ref, extrai o valor interno; se for um valor comum, devolve-o como está.
| Grupo | Reatividade: Utilitários |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
unref(count) // equivale a count.value
unref(42) // 42⚙️ Argumentos
| ref | Um ref ou qualquer valor comum |
|---|
Retorno：O valor interno de um ref, ou o valor original
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'Current count: 17'.💡 Pontos-chave
💡 Dica Use-o nos lugares que precisam do valor dinâmico (concatenação, comparação, passar a bibliotecas fora do Vue) — é o mais prático.
⚠️ Aviso unref(ref(0)) devolve 0 — não use teste de veracidade para saber se “tem valor”; para checagem de tipo, use isRef.
🏷️ Utilitários relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Qual a diferença para escrever .value diretamente?
R unref é seguro com valores comuns (não dá erro); .value aplicado a um valor comum resulta em undefined.
P Ainda é necessário nos templates?
R Não: o template desembrulha automaticamente; ele é usado na lógica JS.
P Qual a diferença para toValue?
R toValue também trata funções getter (3.3+); unref só reconhece refs.
