isReactive() Verificar se é um objeto reativo

Última atualização: 2026-10-22

isReactive() Verificar se é um objeto reativo

isReactive() verifica se um valor foi criado por reactive() (ou por um subproxy dele).

GrupoReatividade: Utilitários
TipoAPI
EscopoNo Componente
Versão do Vue3.0+
Suporte a SSRSim

📝 Sintaxe

isReactive(reactive({}))  // true
isReactive(ref({}))       // true (o objeto interno do ref também é proxy)
isReactive({})            // false

⚙️ Argumentos

valueQualquer valor

Retorno:Booleano

▶ Exemplo

Edite o código abaixo e veja o resultado ao vivo:

Saída:

Shows 'reactive object: true, plain object: false, ref of object: true'.

💡 Pontos-chave

ℹ️ Nota Quando reactive é envolvido por readonly, isReactive ainda devolve true (a camada somente leitura é removida antes da verificação).
💡 Dica Evite empacotamento duplicado: verifique antes de chamar reactive() de novo — se já for um objeto reativo, não é preciso chamar reactive() mais uma vez.
Mais casos em breve.

📚 Tutoriais Relacionados

❓ FAQ

P ref(1) retorna true?
R Não, um ref de primitivo não é um proxy reactive; só ref({}) corresponde.
P Ele reconhece readonly?
R readonly(reactive({})) retorna true; para um readonly puro, use isReadonly para verificar.
P Qual a relação com isProxy?
R isReactive é a verificação do subconjunto gravável de isProxy; para uma verificação mais ampla, use isProxy.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%