toRaw() Recuperar o objeto original
Última atualização: 2026-10-22
toRaw() Recuperar o objeto original
toRaw() devolve o objeto original por trás do proxy: use quando precisar burlar o rastreamento reativo ou passar dados a bibliotecas externas.
| Grupo | Reatividade: Avançado |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
const raw = toRaw(proxy)
raw.count = 5 // a alteração não dispara atualização (fora do rastreamento)⚙️ Argumentos
| proxy | Proxy reactive/readonly ou ref |
|---|
Retorno：O objeto original (sem proxy)
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'same as original: true'.💡 Pontos-chave
ℹ️ Nota Usos típicos: passar dados a bibliotecas de terceiros (gráficos, mapas) para evitar interferência do proxy, ou comparação de identidade de objetos.
⚠️ Aviso Alterar o objeto original não dispara atualização da view — não use para fazer modificação silenciosa burlando a reatividade, pois causa inconsistência entre view e dados.
🏷️ Avançado relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Por que bibliotecas de terceiros precisam dele?
R Algumas bibliotecas julgam estado pela identidade do objeto ou por sua estrutura interna, e o proxy causa comportamento anômalo ou custo extra.
P O que devolve ao usar em um ref?
R Devolve o valor original interno do ref (se o interior for um objeto, devolve o objeto original dele).
P Pode substituir markRaw?
R Não: toRaw é extração; markRaw é marcação para o objeto nunca mais ser proxy.
