isProxy() 値がプロキシかどうかを判定する

最終更新:2026-10-22

isProxy() 値がプロキシかどうかを判定する

isProxy() は値が reactive() または readonly() で作られたプロキシかどうかを判定します。

グループリアクティビティ: ユーティリティ
種類API
スコープコンポーネント内
Vue バージョン3.0+
SSR 対応対応

📝 構文

isProxy(reactive({}))  // true
isProxy(readonly({}))  // true
isProxy(ref(1))        // false

⚙️ 引数

value任意の値

戻り値:真偽値

▶ 例

以下のコードを編集して結果を確認しましょう:

出力:

Shows 'reactive is a proxy: true, readonly is a proxy: true'.

💡 ポイント

ℹ️ 補足 isReactive は書き込み可能なプロキシのみ、isReadonly は読み取り専用プロキシのみを判定します。isProxy はその両方に一致します。
💡 ヒント 「リアクティブなソースかどうか」を判定するときは、isProxy と isRef の組み合わせが便利です。
関連ケースは近日公開予定。

📚 関連チュートリアル

❓ よくある質問

Q ref もプロキシですか?
A 違います。ref は独立したラッパーオブジェクトです(内部の値がプロキシのこともあります)。isProxy(ref(1)) は false です。
Q 実際のプロジェクトではどこで使われますか?
A ライブラリ開発やデバッグ時に、通常のオブジェクトとリアクティブなオブジェクトを区別して二重包装を避けるために使われます。
Q instanceof Proxy と同じですか?
A 違います。Proxy は instanceof では検出できません。Vue が提供する判定関数を使う必要があります。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%