toRaw() استعادة الكائن الأصلي
آخر تحديث: 2026-10-22
toRaw() استعادة الكائن الأصلي
تُعيد toRaw() الكائن الأصلي خلف الوكيل: تُستخدم عند الحاجة إلى تجاوز التتبع التفاعلي، أو عند تسليم البيانات إلى مكتبة خارجية.
| المجموعة | التفاعلية: المتقدم |
|---|---|
| النوع | API |
| النطاق | داخل المكوّن |
| إصدار Vue | 3.0+ |
| دعم SSR | مدعوم |
📝 الصيغة
const raw = toRaw(proxy)
raw.count = 5 // التعديل لا يُطلق تحديثًا (خارج التتبع)⚙️ الوسائط
| proxy | وكيل reactive/readonly أو ref |
|---|
القيمة المُرجعة：الكائن الأصلي (غير مُوكَّع)
▶ مثال
عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:
المخرجات：
Shows 'same as original: true'.💡 نقاط مهمة
ℹ️ ملاحظة استخدامات نموذجية: تمرير البيانات إلى مكتبات خارجية (رسوم بيانية، خرائط) لتجنّب تدخّل الوكيل، أو مقارنة هوية الكائنات.
⚠️ تحذير تعديل الكائن الأصلي لا يُطلق تحديث الواجهة — فلا تستخدمه لإجراء «تعديلات صامتة» تتجاوز التفاعلية، وإلا اختلف العرض عن البيانات.
🏷️ المتقدم ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س لماذا تحتاج المكتبات الخارجية إليها؟
ج تعتمد بعض المكتبات على هوية الكائنات أو بنيتها الداخلية في الحكم على الحالة، والوكلاء قد يُحدثوا سلوكًا شاذًا أو كلفة إضافية.
س ماذا تُعيد عند استخدامها مع ref؟
ج تُعيد القيمة الأصلية الداخلية لـ ref (وإذا كانت القيمة الداخلية كائنًا فتُعاد نسخته الأصلية).
س هل يمكنها أن تحل محل markRaw؟
ج لا: فـ toRaw للاستخراج، بينما markRaw وسم يجعل الكائن لا يُوكَّع أبدًا.
