unref() استخراج قيمة ref
آخر تحديث: 2026-10-22
unref() استخراج قيمة ref
unref() هي اختصار لـ isRef(v) ? v.value : v: تستخرج القيمة الداخلية من ref، وتُعيد القيم العادية كما هي.
| المجموعة | التفاعلية: الأدوات |
|---|---|
| النوع | API |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
unref(count) // تكافئ count.value
unref(42) // 42⚙️ الوسائط
| ref | ref أو أي قيمة عادية |
|---|
القيمة المُرجعة：القيمة الداخلية لـ ref، أو القيمة الأصلية نفسها
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Shows 'Current count: 17'.💡 نقاط مهمة
💡 نصيحة استخدمها لاستخراج القيمة في المواقف التي تحتاج فيها إلى قيمة ديناميكية (تسلسل نصوص، مقارنات، تمرير إلى مكتبات غير Vue) — فهي الأكثر أمانًا.
⚠️ تحذير تُعيد unref(ref(0)) القيمة 0 — فلا تستخدم فحص الصواب/الخطأ لتحديد «وجود قيمة»، بل استخدم isRef لفحص النوع.
🏷️ الأدوات ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س ما الفرق بينها وبين كتابة .value مباشرة؟
ج unref آمنة مع القيم العادية (لا تُخطئ)، بينما تُعطي .value على قيمة عادية النتيجة undefined.
س هل ما زالت مطلوبة في القوالب؟
ج لا حاجة، فالقوالب تفكّ تلقائيًا؛ وهي للاستخدام في منطق JavaScript.
س ما الفرق بينها وبين toValue؟
ج تتعامل toValue كذلك مع دوال getter (من 3.3+)، بينما تقتصر unref على ref فقط.
