toValue() Normalizar extração de valor (valor/ref/getter)
Última atualização: 2026-10-22
toValue() Normalizar extração de valor (valor/ref/getter)
toValue() normaliza valores comuns, refs e funções getter para o valor atual: funções reutilizáveis podem receber as três formas de entrada sem que quem chama precise se preocupar com a diferença.
| Grupo | Reatividade: Utilitários |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.3+ |
| Suporte a SSR | Sim |
📝 Sintaxe
toValue(1) // 1
toValue(count) // count.value
toValue(() => count.value) // count.value (reavaliado a cada chamada)⚙️ Argumentos
| source | Valor comum / ref / função getter que devolve um valor |
|---|
Retorno：O valor atual após a normalização
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows '42'.💡 Pontos-chave
💡 Dica Use-o ao projetar os parâmetros de um composable: quem chama pode passar valor, ref ou getter e tudo funciona, tornando o API mais tolerante.
ℹ️ Nota A forma getter consegue expressar “dependência de outros dados reativos”, que o computed rastreia corretamente.
⚠️ Aviso Disponível apenas a partir do 3.3+; em projetos com versões anteriores, substitua por verificação com isRef e extração manual.
🏷️ Utilitários relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Qual a diferença para unref?
R toValue também aceita funções getter e as reavalia a cada chamada; unref só trata refs.
P Por que não exigir refs diretamente?
R Dá margem a quem usa o composable: valor estático, estado reativo ou lógica computada — as três formas são igualmente naturais.
P Ele é desembrulhado automaticamente nos templates?
R Ele não é um estado em si, mas uma ferramenta de extração em tempo de execução, chamada explicitamente na lógica JS.
