isRef() 値が ref かどうかを判定する
最終更新：2026-10-22
isRef() 値が ref かどうかを判定する
isRef() は値が ref オブジェクトかどうかを判定します。通常の値とリアクティブな参照の両方を扱うユーティリティ関数で便利です。
| グループ | リアクティビティ: ユーティリティ |
|---|---|
| 種類 | API |
| スコープ | コンポーネント内 |
| Vue バージョン | 3.0+ |
| SSR 対応 | 対応 |
📝 構文
isRef(count) // true
isRef(0) // false
isRef(reactive({})) // false（これはリアクティブなプロキシ）⚙️ 引数
| value | 任意の値 |
|---|
戻り値：真偽値
▶ 例
以下のコードを編集して結果を確認しましょう：
出力：
Shows 'a ref / a plain value / a plain value'.💡 ポイント
💡 ヒント ユーティリティ関数を書くときは、まず isRef で判定してから .value で値を取得するか決めましょう。呼び出し側が必ず ref を渡す必要がなくなります。
ℹ️ 補足 reactive プロキシは ref ではありません。オブジェクトにネストされた ref は自動的にアンラップされます。
🏷️ 関連ユーティリティ
💡 関連ケース
関連ケースは近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q どんなときに必要になりますか？
A ref でも通常の値でも受け取れる再利用可能なユーティリティ関数を書くときや、デバッグ時に変数の型を確認するときです。
Q isRef と isReactive に重なりはありますか？
A ありません。ref のラッパーと reactive プロキシは別種のオブジェクトで、それぞれ別に判定します。
Q テンプレート内で判定する必要はありますか？
A 必要ありません。テンプレートは ref を自動的にアンラップするので、普通の値として扱えます。
