isRef() التحقق مما إذا كانت القيمة ref
آخر تحديث: 2026-10-22
isRef() التحقق مما إذا كانت القيمة ref
تحدّد isRef() ما إذا كانت القيمة كائن ref، وتُستخدم كثيرًا في الدوال المساعدة للتمييز بين القيم العادية والمراجع التفاعلية.
| المجموعة | التفاعلية: الأدوات |
|---|---|
| النوع | API |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
isRef(count) // true
isRef(0) // false
isRef(reactive({})) // false (وكيل تفاعلي وليس ref)
⚙️ الوسائط
| value | أي قيمة |
|---|
القيمة المُرجعة:قيمة منطقية
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات:
Shows 'a ref / a plain value / a plain value'.
💡 نقاط مهمة
💡 نصيحة عند كتابة دوال مساعدة استخدم isRef أولًا لتحديد ما إذا كنت بحاجة إلى .value لاستخراج القيمة، حتى لا يُلزمَ المستدعي بتمرير ref دومًا.
ℹ️ ملاحظة وكيل reactive ليس ref؛ والمراجع المتداخلة داخل الكائنات تُفكّ تلقائيًا.
🏷️ الأدوات ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س متى أحتاج إليها؟
ج عند كتابة دوال مساعدة قابلة لإعادة الاستخدام (قد يكون المعامل ref أو قيمة عادية)، أو عند التحقق من نوع المتغير أثناء التنقيح.
س هل تتداخل isRef وisReactive؟
ج لا: فغلاف ref ووكيل reactive مجموعتان مختلفتان من الكائنات، ولكل منهما دالة تحقق خاصة.
س هل أحتاج إلى التحقق داخل القوالب؟
ج لا حاجة، فالقوالب تفكّ ref تلقائيًا وتتعامل معها كقيم عادية.