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