isRef() التحقق مما إذا كانت القيمة ref

آخر تحديث: 2026-10-22

isRef() التحقق مما إذا كانت القيمة ref

تحدّد isRef() ما إذا كانت القيمة كائن ref، وتُستخدم كثيرًا في الدوال المساعدة للتمييز بين القيم العادية والمراجع التفاعلية.

المجموعةالتفاعلية: الأدوات
النوعAPI
النطاقداخل المكوّن
إصدار Vue3.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 تلقائيًا وتتعامل معها كقيم عادية.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%