isReadonly() Verificar se é um proxy somente leitura
Última atualização: 2026-10-22
isReadonly() Verificar se é um proxy somente leitura
isReadonly() verifica se um valor foi criado por readonly() (incluindo proxies somente leitura aninhados).
| Grupo | Reatividade: Utilitários |
|---|---|
| Tipo | API |
| Escopo | No Componente |
| Versão do Vue | 3.0+ |
| Suporte a SSR | Sim |
📝 Sintaxe
isReadonly(readonly({})) // true
isReadonly(reactive({})) // false⚙️ Argumentos
| value | Qualquer valor |
|---|
Retorno：Booleano
▶ Exemplo
Edite o código abaixo e veja o resultado ao vivo:
Saída：
Shows 'readonly object: true, reactive object: false'.💡 Pontos-chave
ℹ️ Nota É uma verificação do subconjunto de isProxy: só reconhece proxies somente leitura.
💡 Dica Ao escrever código de biblioteca, dá para afirmar se a entrada está congelada, evitando falhas inesperadas de escrita em tempo de execução.
🏷️ Utilitários relacionados
💡 Casos Relacionados
Mais casos em breve.
📚 Tutoriais Relacionados
❓ FAQ
P Como verificar um ref envolvido por readonly?
R isReadonly(readonly(ref(1))) retorna true — ele também trata o wrapper de ref.
P É o mesmo que Object.isFrozen?
R Não: readonly é uma camada de proxy; o objeto original não está congelado.
P Para que serve essa verificação?
R Depurar e localizar por que a escrita não tem efeito, ou fazer validação prévia de configurações somente leitura em bibliotecas de componentes.
