getCurrentScope() الحصول على النطاق النشط الحالي

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

getCurrentScope() الحصول على النطاق النشط الحالي

تُعيد getCurrentScope() نطاق effectScope الحالي (أو undefined إن لم يوجد)، وتُستخدم في الدوال المساعدة لتعليق الآثار الجانبية على نطاق المستدعي.

المجموعةالتفاعلية: المتقدم
النوعAPI
النطاقداخل المكوّن
إصدار Vue3.0+
دعم SSRمدعوم

📝 الصيغة

const scope = getCurrentScope()   // داخل setup للمكوّن يكون عادةً نطاق المكوّن
if (scope) scope.stop()

القيمة المُرجعة:الـ EffectScope الحالي أو undefined

▶ مثال

عدّل الشيفرة أدناه وشاهد النتيجة مباشرة:

المخرجات:

Shows 'active scope present'.

💡 نقاط مهمة

ℹ️ ملاحظة عند كتابة المكتبات تُستخدم للحكم على بيئة الاستدعاء (داخل setup/effectScope أم لا) لتحديد انتماء الآثار الجانبية.
💡 نصيحة تُقرن غالبًا بـ onScopeDispose: عند وجود نطاق يُسجَّل التنظيف، وإلا يُتجاهل.
المزيد من الحالات قريباً.

📚 دروس ذات صلة

❓ الأسئلة الشائعة

س ماذا يحدث عند الاستدعاء خارج setup؟
ج تُعيد undefined: أي أنك لست داخل أي نطاق حاليًا (مثل ردود نداء الأحداث العادية).
س ما علاقتها بـ onScopeDispose؟
ج تعتمد onScopeDispose داخليًا على النطاق الحالي؛ وgetCurrentScope هي مدخل الاستعلام عنه.
س هل يمكن إيقاف النطاق الحالي يدويًا؟
ج ممكنة لكنها غير مستحسن: إيقاف نطاق setup يُنظّف معه الآثار الجانبية المرتبطة بالمكوّن.
Web-Tutorial.com

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

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

100%